共用方式為


Resource Groups - Create Or Update

建立或更新資源群組。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01

URI 參數

名稱 位於 必要 類型 Description
resourceGroupName
path True

string

要建立或更新之資源組名。 可以包含英數位元、底線、括號、連字元、句號 (,但結尾) 除外,以及符合允許字元的 Unicode 字元。

Regex 模式: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Microsoft Azure 訂用帳戶標識碼。

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源群組的位置。 建立資源群組之後無法變更它。 它必須是其中一個支援的 Azure 位置。

managedBy

string

管理此資源群組之資源的標識碼。

properties

ResourceGroupProperties

資源群組屬性。

tags

object

附加至資源群組的標記。

回應

名稱 類型 Description
200 OK

ResourceGroup

確定 - 傳回新資源群組的相關信息。

201 Created

ResourceGroup

已建立 - 傳回新資源群組的相關信息。

Other Status Codes

CloudError

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Create or update a resource group

範例要求

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group?api-version=2021-04-01

{
  "location": "eastus"
}

範例回覆

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group",
  "name": "my-resource-group",
  "location": "eastus",
  "properties": {
    "provisioningState": "Succeeded"
  }
}

定義

名稱 Description
CloudError

資源管理要求的錯誤回應。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorResponse

錯誤回應

ResourceGroup

資源群組資訊。

ResourceGroupProperties

資源群組屬性。

CloudError

資源管理要求的錯誤回應。

名稱 類型 Description
error

ErrorResponse

錯誤回應
所有 Azure Resource Manager API 的常見錯誤回應,以傳回失敗作業的錯誤詳細數據。 (這也會遵循 OData 錯誤回應格式。)

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorResponse

錯誤回應

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorResponse[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ResourceGroup

資源群組資訊。

名稱 類型 Description
id

string

資源群組的標識碼。

location

string

資源群組的位置。 建立資源群組之後無法變更它。 它必須是其中一個支援的 Azure 位置。

managedBy

string

管理此資源群組之資源的標識碼。

name

string

資源群組的名稱。

properties

ResourceGroupProperties

資源群組屬性。

tags

object

附加至資源群組的標記。

type

string

資源群組的類型。

ResourceGroupProperties

資源群組屬性。

名稱 類型 Description
provisioningState

string

布建狀態。