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

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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

Nama	Diperlukan	Jenis	Deskripsi
Cache-Control		string	Menunjukkan bahwa permintaan tidak boleh menggunakan cache apa pun.

Isi Permintaan

Nama	Jenis	Deskripsi
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

Nama	Jenis	Deskripsi
200 OK	ManagementGroup	OK
202 Accepted	AzureAsyncOperationResults	Diterima Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Kesalahan

Nama

Jenis

Deskripsi

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Diterima

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Kesalahan

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

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

Scopes

Nama	Deskripsi
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

Nama	Deskripsi
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.

Nama	Jenis	Deskripsi
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
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.

Nama	Jenis	Deskripsi
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-00000000000
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.

Nama	Jenis	Deskripsi
parent	CreateParentGroupInfo	Parent (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.

Nama	Jenis	Deskripsi
id	string	ID yang sepenuhnya memenuhi syarat untuk grup manajemen. Misalnya, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000
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.

Nama	Jenis	Deskripsi
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-00000000000
name	string	Nama grup manajemen induk

ErrorDetails

Detail kesalahan.

Nama	Jenis	Deskripsi
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.

Nama	Jenis	Deskripsi
error	ErrorDetails	Kesalahan Detail kesalahan.