az rest

사용자 지정 요청을 호출합니다.

이 명령은 로그인한 자격 증명을 사용하여 자동으로 인증합니다. 권한 부여 헤더가 설정되지 않은 경우 AAD 검색되는 헤더 Authorization: Bearer <token>``<token> 를 연결합니다. --url이 엔드포인트로 시작하는 경우 토큰의 대상 리소스는 --url에서 az cloud show --query endpoints파생됩니다. 사용자 지정 리소스에 --resource를 사용할 수도 있습니다. Content-Type 헤더가 설정되지 않고 --body가 유효한 JSON 문자열인 경우 Content-Type 헤더는 기본적으로 애플리케이션/json입니다.

Azure CLI복사

 

az rest --uri
        [--body]
        [--headers]
        [--method {delete, get, head, options, patch, post, put}]
        [--output-file]
        [--resource]
        [--skip-authorization-header]
        [--uri-parameters]

예제

Microsoft Graph 통해 감사 로그 가져오기

Azure CLI복사

 

사용해 보세요.

az rest --method get --url https://graph.microsoft.com/beta/auditLogs/directoryAudits

Azure Active Directory Graph 사용자의 표시 이름 업데이트

Azure CLI복사

 

사용해 보세요.

az rest --method patch --url "https://graph.microsoft.com/v1.0/users/johndoe@azuresdkteam.onmicrosoft.com" --body "{\"displayName\": \"jondoe2\"}"

가상 컴퓨터 가져오기

Azure CLI복사

 

사용해 보세요.

az rest --method get --uri /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2019-03-01

body.json 파일에서 공용 IP 주소 만들기

Azure CLI복사

 

사용해 보세요.

az rest --method put --url https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPAddresses/{publicIpAddressName}?api-version=2019-09-01 --body @body.json

상위 3개 리소스 나열(Bash)

Azure CLI복사

 

사용해 보세요.

az rest --method get --url https://management.azure.com/subscriptions/{subscriptionId}/resources?api-version=2019-07-01 --url-parameters \$top=3

필수 매개 변수

--uri --url -u

요청 URL입니다. 호스트로 시작하지 않는 경우 CLI는 이를 Azure 리소스 ID로 가정하고 표시된 현재 클라우드 az cloud show --query endpoints.resourceManager의 ARM 엔드포인트를 접두사로 사용합니다. 일반 토큰 {subscriptionId}가 지정 az account set한 현재 구독 ID로 바뀝니다.

선택적 매개 변수

--body -b

요청 본문. @{file}을(를) 사용하여 파일에서 로드합니다. 다른 터미널에서 문제를 인용하려면 다음을 참조하세요 https://github.com/Azure/azure-cli/blob/dev/doc/use_cli_effectively.md#quoting-issues.

--headers

KEY=VALUE 형식 또는 JSON 문자열의 공백으로 구분된 헤더입니다. @{file}을(를) 사용하여 파일에서 로드합니다.

--method -m

HTTP 요청 메서드입니다.

허용되는 값: delete, get, head, options, patch, post, put

기본값: get

--output-file

응답 페이로드를 파일에 저장합니다.

--resource

CLI가 서비스에 액세스하기 위해 AAD 토큰을 획득해야 하는 리소스 URL입니다. 토큰은 권한 부여 헤더에 배치됩니다. 기본적으로 CLI는 "az cloud show --query endpoints" 목록에 없는 인수를 사용하지 않는 한 --url 인수에 따라 이를 파악할 수 있습니다.

--skip-authorization-header

권한 부여 헤더를 자동으로 추가하지 마세요.

--uri-parameters --url-parameters

URL의 쿼리 매개 변수입니다. KEY=VALUE 형식 또는 JSON 문자열의 공백으로 구분된 쿼리입니다. @{file}을(를) 사용하여 파일에서 로드합니다.

전역 매개 변수