Api Policy - Get Entity Tag

取得識別碼所指定之 API 原則的 (Etag) 版本的實體狀態。

HEAD https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/policies/policy?api-version=2020-12-01

URI 參數

Name In Required Type Description
apiId
path True
  • string

API 修訂識別碼。 在目前的 API 管理服務實例中必須是唯一的。 非目前的修訂具有; rev = n 做為尾碼,其中 n 是修訂編號。

Regex pattern: ^[^*#&+:<>?]+$

policyId
path True

原則的識別碼。

resourceGroupName
path True
  • string

資源群組的名稱。

serviceName
path True
  • string

API 管理服務的名稱。

Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True
  • string

可唯一識別 Microsoft Azure 訂用帳戶的訂用帳號憑證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。

api-version
query True
  • string

要搭配用戶端要求使用的 API 版本。

回應

Name Type Description
200 OK

指定的 API 原則實體存在,而且 ETag 標頭中有目前的實體狀態版本。

Headers

  • ETag: string
Other Status Codes

描述作業為何失敗的錯誤回應。

安全性

azure_auth

Azure Active DirectoryOAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模擬您的使用者帳戶

範例

ApiManagementHeadApiPolicy

Sample Request

HEAD https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/policies/policy?api-version=2020-12-01

Sample Response

etag: AAAAAAAAAAa=

定義

ErrorFieldContract

錯誤欄位合約。

ErrorResponse

錯誤回應。

PolicyIdName

原則的識別碼。

ErrorFieldContract

錯誤欄位合約。

Name Type Description
code
  • string

屬性層級錯誤碼。

message
  • string

人們可讀取的屬性層級錯誤標記法。

target
  • string

屬性名稱。

ErrorResponse

錯誤回應。

Name Type Description
error.code
  • string

服務定義的錯誤碼。 此代碼會作為回應中指定之 HTTP 錯誤碼的子狀態。

error.details

如果發生驗證錯誤,則為不正確欄位清單會送出要求。

error.message
  • string

錯誤的人們可讀取標記法。

PolicyIdName

原則的識別碼。

Name Type Description
policy
  • string