Defender For AI Settings - Create Or Update

サービス:

Azure AI Services

API バージョン:

2024-04-01-preview

指定した Defender for AI 設定を作成または更新します。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}/defenderForAISettings/{defenderForAISettingName}?api-version=2024-04-01-preview

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string minLength: 2 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	Cognitive Services アカウントの名前。
defenderForAISettingName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$	DEFENDER for AI 設定の名前。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソース グループの名前。 名前では大文字と小文字が区別されません。
subscriptionId	path	True	string minLength: 1	ターゲット サブスクリプションの ID。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties.state	DefenderForAISettingState	AI リソースの Defender for AI 状態。
tags	object	リソース タグ。

応答

名前	型	説明
200 OK	DefenderForAISetting	Defender for AI 設定が正常に作成または更新されました。
201 Created	DefenderForAISetting	Defender for AI 設定が正常に作成されました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

例

PutDefenderForAISetting

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/defenderForAISettings/Default?api-version=2024-04-01-preview

{
  "properties": {
    "state": "Enabled"
  }
}

応答のサンプル

状態コード:

200

{
  "name": "Default",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/defenderForAISettings/Default",
  "type": "Microsoft.CognitiveServices/accounts/defenderForAISettings",
  "properties": {
    "state": "Enabled"
  },
  "systemData": {
    "createdBy": "xxx@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-04-03T04:41:33.937Z",
    "lastModifiedBy": "xxx@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-04-03T04:41:33.937Z"
  },
  "etag": "\"00000000-0000-0000-0000-000000000000\""
}

状態コード:

201

{
  "name": "Default",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.CognitiveServices/accounts/accountName/defenderForAISettings/Default",
  "type": "Microsoft.CognitiveServices/accounts/defenderForAISettings",
  "properties": {
    "state": "Enabled"
  },
  "systemData": {
    "createdBy": "xxx@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-04-03T04:41:33.937Z",
    "lastModifiedBy": "xxx@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-04-03T04:41:33.937Z"
  },
  "etag": "\"00000000-0000-0000-0000-000000000000\""
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
DefenderForAISetting	Defender for AI リソース。
DefenderForAISettingState	AI リソースの Defender for AI 状態。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
Application
Key
ManagedIdentity
User

DefenderForAISetting

Object

Defender for AI リソース。

名前	型	説明
etag	string	リソース Etag。
id	string	リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	リソースの名前
properties.state	DefenderForAISettingState	AI リソースの Defender for AI 状態。
systemData	systemData	リソースの作成と最後の変更に関連するメタデータ。
tags	object	リソース タグ。
type	string	リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

DefenderForAISettingState

列挙

AI リソースの Defender for AI 状態。

値	説明
Disabled
Enabled

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細。
message	string	エラー メッセージ。
target	string	エラーターゲット。

ErrorResponse

Object

エラー応答

名前	型	説明
error	ErrorDetail	エラー オブジェクト。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。