이 페이지에서는 Data Transfer Essentials를 사용하여 생성된 리소스를 관리하는 방법을 설명합니다.
구성 관리하기
프로젝트에서 데이터 전송 필수사항 구성을 나열하고, 구성의 상태를 확인하고, 구성을 업데이트하거나 삭제할 수 있습니다.
프로젝트의 구성 나열
프로젝트의 위치에 있는 모든 구성을 나열하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs list 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs list \
--location=LOCATION
LOCATION을 구성의 리전으로 바꿉니다.
API
multicloudDataTransferConfigs.get 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전
선택적으로 requestID 쿼리 매개변수를 사용하여 API 요청을 식별할 수 있습니다. 요청을 다시 시도하면 서버에서 식별자를 사용하여 이미 응답한 요청을 무시할 수 있습니다.
구성 세부정보 보기
구성에 대한 세부정보를 보려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs describe 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs describe CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
CONFIGURATION_NAME: 구성의 이름LOCATION: 구성의 리전
다음 샘플 출력은 compute-engine의 트래픽이 데이터 전송 필수사항 청구에 고려될 준비가 되었음을 보여줍니다. cloud-sql 및 cloud-storage의 경우 업데이트가 대기 중입니다.
effectiveTime 값은 상태가 적용될 것으로 예상되는 시간을 나타냅니다. 이 샘플에서는 구성의 총 대상 수와 활성 상태인 대상 수도 보여줍니다.
description: 'sample config'
destinationsCount: 2
destinationsActiveCount: 0
name: config1
region: https://www.googleapis.com/network-connectivity/v1/projects/my-project/locations/europe-west3
services:
- cloud-sql:
states:
- effectiveTime: 2024-12-12T08:00:00Z
state: DELETING
- cloud-storage:
states:
- effectiveTime: 2024-12-12T08:00:00Z
state: ADDING
- compute-engine:
states:
- state: ACTIVE
…
API
multicloudDataTransferConfigs.list 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 구성의 이름
다음 샘플 출력은 compute-engine의 트래픽이 데이터 전송 필수사항 청구에 고려될 준비가 되었음을 보여줍니다.
cloud-storage 및 cloud-sql의 경우 업데이트가 대기 중입니다.
effectiveTime 값은 상태가 적용될 것으로 예상되는 시간을 나타냅니다. 샘플에는 구성의 총 대상 수와 활성 상태인 대상 수도 표시됩니다.
{
"multicloudDataTransferConfig": [
{
"name": "projects/test-project/locations/europe-west1/multicloudDataTransferConfigs/config1",
"createTime": "2025-05-14T10:16:22.761275571Z",
"updateTime": "2025-05-14T10:16:25.872465362Z",
"etag": "l-WY4OT6hBsMT8sAwEbuSpviLsE9iC_UDJXDyfE265I",
"description": "sample config",
"destinationsCount": 1,
"destinationsActiveCount": 1,
"services": {
"cloud-sql": {
"states": [
{
"effectiveTime": "2025-05-29T07:00:00Z",
"state": "DELETING"
}
]
},
"cloud-storage": {
"states": [
{
"effectiveTime": "2025-05-29T07:00:00Z",
"state": "ADDING"
}
]
},
"compute-engine": {
"states": [
{
"state": "ACTIVE"
}
]
}
}
}
]
}
서비스의 상태는 다음 중 하나일 수 있습니다.
ADDING: 서비스가 추가되고 있습니다.DELETING: 서비스가 삭제되고 있습니다.ACTIVE: 서비스가 Data Transfer Essentials 결제로 구성됩니다.
구성 업데이트
구성에서 서비스를 추가하거나 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs update 명령어를 사용합니다.
서비스를 지정하려면 다음 옵션 중 하나를 사용하세요.
services: 구성의 서비스를 지정된 목록으로 대체합니다.update-services: 지정된 서비스를 구성에 추가합니다.remove-services: 구성에서 지정된 서비스를 삭제합니다.clear-services: 구성에서 모든 서비스를 삭제합니다.
gcloud network-connectivity multicloud-data-transfer-configs update CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--services=SERVICE-A,... |
--update-services=SERVICE-A,... |
--remove-services=SERVICE-A,... |
--clear-services
다음을 바꿉니다.
CONFIGURATION_NAME: 업데이트하려는 구성의 이름LOCATION: 구성의 리전입니다.DESCRIPTION: 구성 및 그 목적에 대한 설명입니다.SERVICE-A,...: 구성에서 추가하거나 삭제할 서비스를 나타내는 문자열 시리즈입니다. 유효한 문자열은 지원되는 서비스 및 리전을 참고하세요.clear-services을 사용하여 구성에서 모든 서비스를 삭제합니다.
API
multicloudDataTransferConfigs.update 메서드를 사용합니다.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
{
"description": "DESCRIPTION",
"services": {
"SERVICE-A",
"SERVICE-B"
}
}
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.LOCATION: 구성의 리전입니다.CONFIGURATION_NAME: 구성의 이름DESCRIPTION: 구성 및 그 목적에 대한 설명입니다.SERVICE-A: 구성에서 추가하거나 삭제할 서비스를 나타내는 문자열의 시리즈입니다. 유효한 문자열은 지원되는 서비스 및 리전을 참고하세요.
또한 업데이트 작업 중에 지정된 필드 집합이 덮어쓰이지 않도록 하려면 fieldMask 형식을 따르는 updateMask 옵션을 사용하면 됩니다.
데이터 전송 필수사항 구성 업데이트는 약 24시간 후에 적용됩니다.
구성 삭제
구성과 연결된 모든 대상을 삭제한 후에만 구성을 삭제할 수 있습니다.
구성을 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs delete 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs delete CONFIGURATION_NAME \
--location=LOCATION
API
multicloudDataTransferConfigs.delete 메서드를 사용합니다.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
연결 대상 관리
프로젝트에서 데이터 전송 필수사항 대상 유형을 나열하고, 대상 유형의 상태를 확인하고, 대상 유형을 업데이트하거나 삭제할 수 있습니다.
프로젝트의 대상 목록
프로젝트의 모든 대상을 나열하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations list 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations list \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
CONFIGURATION_NAME: 대상을 나열하려는 구성의 이름LOCATION: 구성의 리전
API
multicloudDataTransferConfigs.destinations.list 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 대상을 나열하려는 구성의 이름
대상 세부정보 보기
대상 세부정보를 보려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations describe 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations describe DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
다음을 바꿉니다.
DESTINATION_NAME: 대상 이름CONFIGURATION_NAME: 대상을 보려는 구성의 이름LOCATION: 구성의 리전
다음 샘플에서는 destination1에 지정된 엔드포인트가 유효하며 effectiveTime로 표시된 시간까지 대상이 추가되고 있음을 보여줍니다.
createTime: '2025-05-28T13:08:00.171978514Z'
description: 'sample destination'
endpoints:
- asn: 16509
csp: aws
state: VALID
etag: tag1
ipPrefix: 203.0.113.0/24
name: projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1
stateTimeline:
states:
- effectiveTime: '2025-05-29T07:00:00Z'
state: ADDING
updateTime: '2025-05-28T13:08:03.431862259Z'
…
API
multicloudDataTransferConfigs.destinations.get 메서드를 사용합니다.
GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 IDLOCATION: 구성의 리전CONFIGURATION_NAME: 구성의 이름DESTINATION_NAME: 대상 이름
다음 샘플 출력은 destination1에 지정된 엔드포인트가 유효하며 effectiveTime로 표시된 시간까지 대상이 추가됨을 보여줍니다.
{
"destination": [
{
"name": "projects/test-project/locations/europe-west3/multicloudDataTransferConfig/config1/destinations/destination1",
"createTime": "2025-05-14T10:18:16.941520739Z",
"updateTime": "2025-05-14T10:18:20.028116272Z",
"etag": "tag1",
"description": "sample destination",
"ipPrefix": "203.0.113.0/24",
"endpoints": [
{
"asn": 16509,
"csp": "aws",
"state": "VALID"
}
],
"stateTimeline": {
"states": [
{
"state": "ADDING",
"effectiveTime": "2025-05-29T07:00:00Z"
}
]
}
}
]
}
대상에 대해 상태는 다음 중 하나일 수 있습니다.
ADDING: 대상이 추가되고 있습니다.DELETING: 대상이 삭제되는 중입니다.SUSPENDING: 감사에 따라 대상이 정지됩니다.ACTIVE: 대상이 데이터 전송 필수사항 결제에 고려됩니다.SUSPENDED: 대상이 삭제되었거나 사용 약관을 위반하여 데이터 전송 필수사항 청구에 고려되지 않습니다.
엔드포인트의 경우 상태는 다음 중 하나일 수 있습니다.
VALID: ASN과 CSP 값의 조합이 유효합니다.INVALID: ASN 및 CSP 값의 조합이 유효하지 않습니다.
하나의 엔드포인트라도 상태가 VALID이면 대상이 데이터 전송 필수 기능 청구 대상인 것으로 간주됩니다.
모든 엔드포인트의 상태가 INVALID이면 대상이 데이터 전송 필수사항 청구에 적합하지 않은 것으로 간주됩니다. 이 경우 현재 상태가 ADDING인지 ACTIVE인지에 따라 대상의 상태가 SUSPENDING 또는 SUSPENDED로 설정됩니다. 이러한 대상에 대한 트래픽은 일반 인터넷 트래픽으로 취급됩니다.
대상 업데이트
대상에는 엔드포인트가 하나 이상 있어야 하며 엔드포인트가 5개를 초과할 수 없습니다.
대상에서 엔드포인트를 추가하거나 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations update 명령어를 사용합니다.
엔드포인트를 지정하려면 다음 옵션 중 하나를 사용하세요. 동일한 명령에서 add-endpoints 또는 remove-endpoints 플래그를 여러 번 지정할 수 있습니다.
endpoints: 대상의 엔드포인트를 지정된 목록으로 바꿉니다.add-endpoints: 지정된 엔드포인트를 대상에 추가합니다.remove-endpoints: 대상에서 지정된 엔드포인트를 삭제합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations update DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION \
--description=DESCRIPTION \
--ip-prefix=IP_PREFIX \
--endpoints=asn=ASN,csp=CSP |
--add-endpoints=asn=ASN,csp=CSP |
--remove-endpoints=asn=ASN,csp=CSP
다음을 바꿉니다.
DESTINATION_NAME: 대상의 이름입니다.CONFIGURATION_NAME: 업데이트하려는 구성의 이름LOCATION: 구성의 리전입니다.DESCRIPTION: 대상 및 대상의 용도에 대한 설명입니다.IP_PREFIX: 범위 또는 값으로 지정된 대상의 IP 접두사입니다.각 엔드포인트에 대해 다음을 지정합니다.
ASN: 프리픽스를 공지할 것으로 예상되는 ASN입니다. 인식된 ASN을 참고하세요.CSP: 접두사를 알리는 ASN의 CSP를 나타내는 문자열입니다.
API
multicloudDataTransferConfigs.destinations.update 메서드를 사용합니다.
PATCH https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME
{
"description": "DESCRIPTION",
"ip_prefix": "IP_PREFIX",
"endpoints": [
{
"asn": "ASN",
"csp": "CSP"
}
]
}
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.LOCATION: 구성의 리전입니다.CONFIGURATION_NAME: 구성의 이름DESTINATION_NAME: 대상의 이름입니다.DESCRIPTION: 대상 및 대상의 용도에 대한 설명입니다.IP_PREFIX: 범위 (예:203.0.113.0/24또는2001:db8::/32) 또는 값 (예:203.0.113.6또는2001:db8:2:2:2:2:2:2)으로 지정된 대상의 IP 접두사입니다. IP 접두사는 구성에서 한 번만 사용해야 하며 하나의 ASN에만 사용해야 합니다.대상에 추가할 엔드포인트에 해당하는 문자열을 지정하거나 대상에 유지하지 않을 엔드포인트를 삭제합니다.
ASN: 프리픽스를 공지할 것으로 예상되는 ASN입니다. 인식된 ASN을 참고하세요.CSP: 접두사를 알리는 ASN의 CSP를 나타내는 문자열입니다.
또한 업데이트 작업 중에 지정된 필드 집합이 덮어쓰이지 않도록 하려면 fieldMask 형식을 따르는 updateMask 옵션을 사용하면 됩니다.
데이터 전송 필수사항 도착 페이지 및 관련 구성 업데이트는 약 24시간 후에 적용됩니다.
대상 삭제
대상을 삭제하려면 다음 방법 중 하나를 사용하세요.
gcloud
gcloud network-connectivity multicloud-data-transfer-configs destinations delete 명령어를 사용합니다.
gcloud network-connectivity multicloud-data-transfer-configs destinations delete DESTINATION_NAME \
--multicloud-data-transfer-config=CONFIGURATION_NAME \
--location=LOCATION
API
multicloudDataTransferConfigs.destinations.delete 메서드를 사용합니다.
DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/multicloudDataTransferConfigs/CONFIGURATION_NAME/destinations/DESTINATION_NAME