Microsoft.ApiManagement 服務/namedValues 2021-08-01

  • 發行項

Bicep 資源定義

服務/namedValues 資源類型可以使用目標作業進行部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ApiManagement/service/namedValues 資源，請將下列 Bicep 新增至您的範本。

resource symbolicname 'Microsoft.ApiManagement/service/namedValues@2021-08-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    displayName: 'string'
    keyVault: {
      identityClientId: 'string'
      secretIdentifier: 'string'
    }
    secret: bool
    tags: [
      'string'
    ]
    value: 'string'
  }
}

屬性值

service/namedValues

名稱 描述 值
NAME 資源名稱

瞭解如何在 Bicep 中設定子資源的名稱和類型。		 需要字串 ()
父系 (parent) 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增此屬性。

如需詳細資訊，請參閱 父資源外部的子資源。		 類型資源的符號名稱： service
properties PUT 作業的 NamedValue 實體合約屬性。 NamedValueCreateContractPropertiesOrNamedValueContra...

NamedValueCreateContractPropertiesOrNamedValueContra...

名稱 描述 值
displayName NamedValue 的唯一名稱。 只能包含字母、數字、句點、破折號和底線字元。 需要字串 ()
keyVault namedValue的KeyVault位置詳細數據。 KeyVaultContractCreatePropertiesOrKeyVaultContractPr...
secret 決定該值是否為密碼且是否應該加密。 預設值為 False。 bool
tags 提供時可用來篩選 NamedValue 清單的選擇性標籤。 string[]
值 NamedValue 的值。 可以包含原則表達式。 不能是空白或只由空白字元組成。 此屬性不會填入 『GET』 作業！ 使用 '/listSecrets' POST 要求來取得值。 字串

KeyVaultContractCreatePropertiesOrKeyVaultContractPr...

名稱 描述 值
identityClientId SystemAssignedIdentity 的 Null 或 UserAssignedIdentity 的用戶端識別符，將用來存取密鑰保存庫秘密。 字串
secretIdentifier 用於擷取秘密的金鑰保存庫秘密標識碼。 提供已建立版本的秘密將會防止自動重新整理。 這需要 API 管理 服務設定 aka.ms/apimmsi 字串

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
具有 API 管理 來源的 Front Door Standard/Premium

部署至 Azure		 此範本會建立 Front Door Premium 和 API 管理 實例，並使用 NSG 和全域 API 管理 原則來驗證流量是否通過 Front Door 來源。

ARM 範本資源定義

服務/namedValues 資源類型可以使用目標作業進行部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.ApiManagement/service/namedValues 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.ApiManagement/service/namedValues",
  "apiVersion": "2021-08-01",
  "name": "string",
  "properties": {
    "displayName": "string",
    "keyVault": {
      "identityClientId": "string",
      "secretIdentifier": "string"
    },
    "secret": "bool",
    "tags": [ "string" ],
    "value": "string"
  }
}

屬性值

service/namedValues

名稱 描述 值
類型 資源類型 'Microsoft.ApiManagement/service/namedValues'
apiVersion 資源 API 版本 '2021-08-01'
NAME 資源名稱

瞭解如何在 JSON ARM 範本中設定子資源的名稱和類型。		 字串 (必要)
properties PUT 作業的 NamedValue 實體合約屬性。 NamedValueCreateContractPropertiesOrNamedValueContra...

NamedValueCreateContractPropertiesOrNamedValueContra...

名稱 描述 值
displayName NamedValue 的唯一名稱。 只能包含字母、數字、句點、破折號和底線字元。 字串 (必要)
keyVault namedValue的KeyVault位置詳細數據。 KeyVaultContractCreatePropertiesOrKeyVaultContractPr...
secret 決定該值是否為密碼且是否應該加密。 預設值為 False。 bool
tags 選擇性標記，當提供時可用來篩選 NamedValue 清單。 string[]
值 NamedValue 的值。 可以包含原則表達式。 不能是空白或只由空白字元組成。 此屬性不會填入 『GET』 作業！ 使用 '/listSecrets' POST 要求來取得值。 字串

KeyVaultContractCreatePropertiesOrKeyVaultContractPr...

名稱 描述 值
identityClientId SystemAssignedIdentity 的 Null 或 UserAssignedIdentity 的用戶端識別符，其將用來存取密鑰保存庫密碼。 字串
secretIdentifier 用於擷取秘密的金鑰保存庫秘密標識碼。 提供已設定版本的秘密會防止自動重新整理。 這需要 API 管理 服務設定 aka.ms/apimmsi 字串

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
具有 API 管理 來源的 Front Door Standard/Premium

部署至 Azure		 此範本會建立 Front Door Premium 和 API 管理 實例，並使用 NSG 和全域 API 管理 原則來驗證流量是否已通過 Front Door 來源。

Terraform (AzAPI 提供者) 資源定義

服務/namedValues 資源類型可以使用目標作業來部署：

  • 資源群組

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄。

資源格式

若要建立 Microsoft.ApiManagement/service/namedValues 資源，請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/namedValues@2021-08-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      displayName = "string"
      keyVault = {
        identityClientId = "string"
        secretIdentifier = "string"
      }
      secret = bool
      tags = [
        "string"
      ]
      value = "string"
    }
  })
}

屬性值

service/namedValues

名稱 描述 值
類型 資源類型 “Microsoft.ApiManagement/service/namedValues@2021-08-01”
NAME 資源名稱 字串 (必要)
parent_id 此資源之父系的資源標識碼。 類型資源的標識碼： 服務
properties PUT 作業的 NamedValue 實體合約屬性。 NamedValueCreateContractPropertiesOrNamedValueContra...

NamedValueCreateContractPropertiesOrNamedValueContra...

名稱 描述 值
displayName NamedValue 的唯一名稱。 只能包含字母、數字、句點、破折號和底線字元。 字串 (必要)
keyVault namedValue的KeyVault位置詳細數據。 KeyVaultContractCreatePropertiesOrKeyVaultContractPr...
secret 決定該值是否為密碼且是否應該加密。 預設值為 False。 bool
tags 選擇性標記，當提供時可用來篩選 NamedValue 清單。 string[]
值 NamedValue 的值。 可以包含原則表達式。 不能是空白或只由空白字元組成。 此屬性不會填入 『GET』 作業！ 使用 '/listSecrets' POST 要求來取得值。 字串

KeyVaultContractCreatePropertiesOrKeyVaultContractPr...

名稱 描述 值
identityClientId SystemAssignedIdentity 的 Null 或 UserAssignedIdentity 的用戶端識別符，將用來存取密鑰保存庫秘密。 字串
secretIdentifier 用於擷取秘密的金鑰保存庫秘密標識碼。 提供已建立版本的秘密將會防止自動重新整理。 這需要以 aka.ms/apimmsi 設定 API 管理 服務 字串