Cloud Number Registry 쿼리
이 페이지에서는 Cloud Number Registry에 저장된 정보를 쿼리하는 방법을 설명합니다.
시작하기 전에
- Cloud Number Registry 설정
- Cloud Number Registry 액세스를 제공하도록 구성된 조직의 프로젝트를 선택합니다.
- 이 가이드를 완료하는 데 필요한 권한이 있는지 확인합니다.
필요한 역할
Cloud Number Registry에 저장된 정보를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud Number Registry IPAM 뷰어 (roles/cloudnumberregistry.ipamViewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
IP 주소 사용률 표시
검색된 범위 또는 맞춤 범위의 IP 주소 사용률을 확인할 수 있습니다.
검색된 범위의 사용률 표시
gcloud
gcloud alpha number-registry discovered-ranges show-utilization 명령어를 사용하여 검색된 범위의 사용률을 표시합니다.
gcloud alpha number-registry discovered-ranges show-utilization DISCOVERED_RANGE_NAME \
--location=global
다음을 바꿉니다.
DISCOVERED_RANGE_NAME: 검색된 범위의 이름입니다.
맞춤 범위의 사용률 표시
gcloud
gcloud alpha number-registry custom-ranges show-utilization 명령어를 사용하여 맞춤 범위의 사용률을 표시합니다.
gcloud alpha number-registry custom-ranges show-utilization CUSTOM_RANGE_NAME \
--location=global
다음을 바꿉니다.
CUSTOM_RANGE_NAME: 맞춤 범위의 이름입니다.
사용 가능한 IP 범위 찾기
검색된 범위 또는 맞춤 범위 내에서 사용 가능한 IP 주소 범위를 확인할 수 있습니다.
탐색된 범위에서 사용 가능한 IP 범위 찾기
검색된 범위에서 사용 가능한 IP 범위를 찾으면 다음 제한사항이 적용됩니다.
결과에는 IPv4 서브넷 범위의 사용할 수 없는 주소와 IPv6 서브넷 범위의 사용할 수 없는 주소가 포함될 수 있습니다.
결과에는 종료된 인스턴스에 할당된 임시 IP 주소가 포함될 수 있습니다.
gcloud
gcloud alpha number-registry discovered-ranges find-free-ip-ranges 명령어를 사용하여 검색된 범위에서 사용 가능한 IP 범위를 찾습니다.
gcloud alpha number-registry discovered-ranges find-free-ip-ranges DISCOVERED_RANGE_NAME \
--cidr-prefix-length=PREFIX_LENGTH \
--range-count=RANGE_COUNT \
--location=global
다음을 바꿉니다.
DISCOVERED_RANGE_NAME: 검색된 범위의 이름입니다.PREFIX_LENGTH: 찾을 범위의 CIDR 프리픽스 길이입니다.32을 사용하여 개별 IPv4 주소를 찾습니다.RANGE_COUNT: 찾을 여유 범위의 수입니다.
커스텀 범위에서 사용 가능한 IP 범위 찾기
특정 IP 주소 범위에 맞춤 범위가 없으면 해당 범위는 사용 가능한 IP 범위로 간주됩니다. Cloud Number Registry를 사용하여 맞춤 범위 내에서 사용 가능한 IP 범위를 찾으려면 사용 중인 모든 IP 주소와 IP 주소 범위에 해당하는 맞춤 범위가 있어야 합니다.
gcloud
gcloud alpha number-registry custom-ranges find-free-ip-ranges 명령어를 사용하여 맞춤 범위에서 사용 가능한 IP 범위를 찾습니다.
gcloud alpha number-registry custom-ranges find-free-ip-ranges CUSTOM_RANGE_NAME \
--cidr-prefix-length=PREFIX_LENGTH \
--range-count=RANGE_COUNT \
--location=global
다음을 바꿉니다.
CUSTOM_RANGE_NAME: 맞춤 범위의 이름입니다.PREFIX_LENGTH: 찾을 범위의 CIDR 프리픽스 길이입니다.32을 사용하여 개별 IPv4 주소를 찾습니다.RANGE_COUNT: 찾을 여유 범위의 수입니다.
IP 주소 리소스 검색
레지스트리 북 내에서 IP 주소 리소스를 검색할 수 있습니다.
쿼리에서 다음 필터를 사용할 수 있습니다.
realm: 검색할 렐름 이름(예:prod-realm-5)parent_range: 검색하려는 상위 범위의 URI입니다(예:projects/project3/locations/global/customRanges/range7).ip_address: 검색할 IP 주소(예:10.10.10.46)ip_version: 필터링할 IP 버전입니다.attribute_text: 범위 내에서 검색할 속성 텍스트입니다(예:production).attribute: 필터링할 속성 키와 값입니다(예:attribute:(environment=production)).
다음과 같은 방법으로 필터를 결합할 수 있습니다.
AND을 사용하여 동일한 쿼리에서 두 개 이상의 필터를 결합할 수 있습니다.AND NOT는attribute:(KEY=VALUE)필터와 함께만 사용할 수 있습니다.주어진 쿼리에서
attribute또는attribute_text중 하나를 사용할 수 있지만 둘 다 사용할 수는 없습니다.
gcloud
gcloud alpha number-registry registry-books search-ip-resources 명령어를 사용하여 IP 리소스를 검색합니다.
gcloud alpha number-registry registry-books search-ip-resources REGISTRY_BOOK \
--query=QUERY \
--show-utilization \
--location=global
다음을 바꿉니다.
REGISTRY_BOOK: 검색할 레지스트리 책의 이름입니다.QUERY: 검색어입니다(예:- ).
"attribute:(resourceName=projects/project123/regions/us-east1/subnetworks/subnet1)""realm=vpc-global-123456789 AND ip_address=10.10.10.46""realm=vpc-global-123456789 AND ip_version=IPV6""ip_address=\"2001:db8::/64\"""realm=vpc-global-123456789 AND attribute_text=production""realm=vpc-global-123456789 AND attribute:(team=\"Sales Europe\")""parent_range=projects/project3/locations/global/customRanges/range7 AND attribute:(team=marketing)""parent_range=projects/project3/locations/global/customRanges/range7 AND NOT attribute:(environment=production)"