Management Groups - Create Or Update

Referensi

Service:: Management Groups

API Version:: 2020-05-01

Membuat atau memperbarui grup manajemen. Jika grup manajemen sudah dibuat dan permintaan pembuatan berikutnya dikeluarkan dengan properti yang berbeda, properti grup manajemen akan diperbarui.

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01

Parameter URI

Name	In	Required	Type	Description
groupId	path	True	string	ID Grup Manajemen.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2018-01-01-preview.

Header Permintaan

Name	Required	Type	Description
Cache-Control		string	Menunjukkan bahwa permintaan tidak boleh menggunakan cache apa pun.

Isi Permintaan

Name	Type	Description
name	string	Nama grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
properties.details	CreateManagementGroupDetails	Detail Detail grup manajemen yang digunakan selama pembuatan.
properties.displayName	string	Nama grup manajemen yang mudah diingat. Jika tidak ada nilai yang diteruskan maka bidang ini akan diatur ke groupId.

Respons

Name	Type	Description
200 OK	ManagementGroup	OK
202 Accepted	AzureAsyncOperationResults	Diterima Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Kesalahan

Name

Type

Description

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Diterima

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Kesalahan

Keamanan

azure_auth

Azure Active Directory Flow OAuth2.

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

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

PutManagementGroup

Sample Request

HTTP

PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/ChildGroup?api-version=2020-05-01


{
  "properties": {
    "displayName": "ChildGroup",
    "details": {
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup"
      }
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "displayName": "ChildGroup",
    "details": {
      "version": 1,
      "updatedTime": "2018-01-01T00:00:00.00Z",
      "updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup",
        "name": "RootGroup",
        "displayName": "RootGroup"
      }
    }
  }
}

Status code:: 202

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "status": "NotStarted"
}

Definisi

AzureAsyncOperationResults	Hasil dari Azure-AsyncOperation.
CreateManagementGroupChildInfo	Informasi anak dari grup manajemen yang digunakan selama pembuatan.
CreateManagementGroupDetails	Detail grup manajemen yang digunakan selama pembuatan.
CreateManagementGroupRequest	Parameter pembuatan grup manajemen.
CreateParentGroupInfo	(Opsional) ID grup manajemen induk yang digunakan selama pembuatan.
ErrorDetails	Detail kesalahan.
ErrorResponse	Objek kesalahan.
ManagementGroup	Detail grup manajemen.
ManagementGroupChildInfo	Informasi anak dari grup manajemen.
ManagementGroupChildType	Jenis sumber daya anak.
ManagementGroupDetails	Detail grup manajemen.
ManagementGroupPathElement	Elemen jalur dari leluhur grup manajemen.
ParentGroupInfo	(Opsional) ID grup manajemen induk.

AzureAsyncOperationResults

Hasil dari Azure-AsyncOperation.

Name	Type	Description
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
properties.displayName	string	Nama grup manajemen yang mudah diingat.
properties.tenantId	string	ID Penyewa AAD yang terkait dengan grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
status	string	Status saat ini dari operasi asinkron yang dilakukan . Misalnya, Berjalan, Berhasil, Gagal
type	string	Jenis sumber daya. Misalnya, Microsoft.Management/managementGroups

CreateManagementGroupChildInfo

Informasi anak dari grup manajemen yang digunakan selama pembuatan.

Name	Type	Description
children	CreateManagementGroupChildInfo[]	Daftar anak-anak.
displayName	string	Nama sumber daya anak yang mudah diingat.
id	string	ID yang sepenuhnya memenuhi syarat untuk sumber daya anak (grup manajemen atau langganan). Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama entitas anak.
type	ManagementGroupChildType	Jenis sumber daya anak. Jenis sumber daya yang sepenuhnya memenuhi syarat yang mencakup namespace penyedia (misalnya Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Detail grup manajemen yang digunakan selama pembuatan.

Name	Type	Description
parent	CreateParentGroupInfo	Induk (Opsional) ID grup manajemen induk yang digunakan selama pembuatan.
updatedBy	string	Identitas prinsipal atau proses yang memperbarui objek.
updatedTime	string	Tanggal dan waktu saat objek ini terakhir diperbarui.
version	number	Nomor versi objek.

CreateManagementGroupRequest

Parameter pembuatan grup manajemen.

Name	Type	Description
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
properties.children	CreateManagementGroupChildInfo[]	Daftar anak-anak.
properties.details	CreateManagementGroupDetails	Detail Detail grup manajemen yang digunakan selama pembuatan.
properties.displayName	string	Nama grup manajemen yang mudah diingat. Jika tidak ada nilai yang diteruskan maka bidang ini akan diatur ke groupId.
properties.tenantId	string	ID Penyewa AAD yang terkait dengan grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
type	string	Jenis sumber daya. Misalnya, Microsoft.Management/managementGroups

CreateParentGroupInfo

(Opsional) ID grup manajemen induk yang digunakan selama pembuatan.

Name	Type	Description
displayName	string	Nama yang mudah diingat dari grup manajemen induk.
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen induk. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama grup manajemen induk

ErrorDetails

Detail kesalahan.

Name	Type	Description
code	string	Salah satu set kode kesalahan yang ditentukan server.
details	string	Representasi yang dapat dibaca manusia dari detail kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.

ErrorResponse

Objek kesalahan.

Name	Type	Description
error	ErrorDetails	Kesalahan Detail kesalahan.

ManagementGroup

Detail grup manajemen.

Name	Type	Description
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
properties.children	ManagementGroupChildInfo[]	Daftar anak-anak.
properties.details	ManagementGroupDetails	Detail Detail grup manajemen.
properties.displayName	string	Nama grup manajemen yang mudah diingat.
properties.tenantId	string	ID Penyewa AAD yang terkait dengan grup manajemen. Misalnya, 00000000-0000-0000-0000-000000000000
type	string	Jenis sumber daya. Misalnya, Microsoft.Management/managementGroups

ManagementGroupChildInfo

Informasi anak dari grup manajemen.

Name	Type	Description
children	ManagementGroupChildInfo[]	Daftar anak-anak.
displayName	string	Nama sumber daya anak yang mudah diingat.
id	string	ID yang sepenuhnya memenuhi syarat untuk sumber daya anak (grup manajemen atau langganan). Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama entitas anak.
type	ManagementGroupChildType	Jenis sumber daya anak. Jenis sumber daya yang sepenuhnya memenuhi syarat yang mencakup namespace penyedia (misalnya Microsoft.Management/managementGroups)

ManagementGroupChildType

Jenis sumber daya anak.

Name	Type	Description
/subscriptions	string
Microsoft.Management/managementGroups	string

ManagementGroupDetails

Detail grup manajemen.

Name	Type	Description
parent	ParentGroupInfo	Induk (Opsional) ID grup manajemen induk.
path	ManagementGroupPathElement[]	Jalur dari akar ke grup saat ini.
updatedBy	string	Identitas prinsipal atau proses yang memperbarui objek.
updatedTime	string	Tanggal dan waktu saat objek ini terakhir diperbarui.
version	number	Nomor versi objek.

ManagementGroupPathElement

Elemen jalur dari leluhur grup manajemen.

Name	Type	Description
displayName	string	Nama grup yang mudah diingat.
name	string	Nama grup.

ParentGroupInfo

(Opsional) ID grup manajemen induk.

Name	Type	Description
displayName	string	Nama yang mudah diingat dari grup manajemen induk.
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen induk. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nama grup manajemen induk