User - Create Or Update

Referensi

Service:: API Management

API Version:: 2021-08-01

Membuat atau Memperbarui pengguna.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}?api-version=2021-08-01

With optional parameters:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/users/{userId}?notify={notify}&api-version=2021-08-01

Parameter URI

Name	In	Required	Type	Description
resourceGroupName	path	True	string	Nama grup sumber daya.
serviceName	path	True	string	Nama layanan API Management. Regex pattern: `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`
subscriptionId	path	True	string	Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
userId	path	True	string	Pengidentifikasi pengguna. Harus unik dalam instans layanan API Management saat ini.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien.
notify	query		boolean	Kirim pemberitahuan Email ke Pengguna.

Header Permintaan

Name	Required	Type	Description
If-Match		string	ETag Entitas. Tidak diperlukan saat membuat entitas, tetapi diperlukan saat memperbarui entitas.

Isi Permintaan

Name	Required	Type	Description
properties.email	True	string	Alamat Email. Tidak boleh kosong dan harus unik dalam instans layanan.
properties.firstName	True	string	Nama depan.
properties.lastName	True	string	Nama belakang.
properties.appType		AppType	Menentukan jenis aplikasi yang mengirim permintaan buat pengguna. Defaultnya adalah portal warisan.
properties.confirmation		Confirmation	Menentukan jenis email konfirmasi yang akan dikirim ke pengguna yang baru dibuat.
properties.identities		UserIdentityContract[]	Kumpulan identitas pengguna.
properties.note		string	Catatan opsional tentang pengguna yang ditetapkan oleh administrator.
properties.password		string	Kata Sandi Pengguna. Jika tidak ada nilai yang disediakan, kata sandi default akan dibuat.
properties.state		UserState	Status akun. Menentukan apakah pengguna aktif atau tidak. Pengguna yang diblokir tidak dapat masuk ke portal pengembang atau memanggil API apa pun dari produk langganan. Status default adalah Aktif.

Respons

Name	Type	Description
200 OK	UserContract	Pengguna berhasil diperbarui. Headers ETag: string
201 Created	UserContract	Pengguna berhasil dibuat. Headers ETag: string
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Name

Type

Description

200 OK

UserContract

Pengguna berhasil diperbarui.

Headers

ETag: string

201 Created

UserContract

Pengguna berhasil dibuat.

Headers

ETag: string

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

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

ApiManagementCreateUser

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512288c680b?api-version=2021-08-01

{
  "properties": {
    "firstName": "foo",
    "lastName": "bar",
    "email": "foobar@outlook.com",
    "confirmation": "signup"
  }
}

import com.azure.resourcemanager.apimanagement.models.Confirmation;

/** Samples for User CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2021-08-01/examples/ApiManagementCreateUser.json
     */
    /**
     * Sample code: ApiManagementCreateUser.
     *
     * @param manager Entry point to ApiManagementManager.
     */
    public static void apiManagementCreateUser(com.azure.resourcemanager.apimanagement.ApiManagementManager manager) {
        manager
            .users()
            .define("5931a75ae4bbd512288c680b")
            .withExistingService("rg1", "apimService1")
            .withEmail("foobar@outlook.com")
            .withFirstName("foo")
            .withLastName("bar")
            .withConfirmation(Confirmation.SIGNUP)
            .create();
    }
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

package armapimanagement_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/apimanagement/armapimanagement"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2021-08-01/examples/ApiManagementCreateUser.json
func ExampleUserClient_CreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	client, err := armapimanagement.NewUserClient("subid", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := client.CreateOrUpdate(ctx,
		"rg1",
		"apimService1",
		"5931a75ae4bbd512288c680b",
		armapimanagement.UserCreateParameters{
			Properties: &armapimanagement.UserCreateParameterProperties{
				Confirmation: to.Ptr(armapimanagement.ConfirmationSignup),
				Email:        to.Ptr("foobar@outlook.com"),
				FirstName:    to.Ptr("foo"),
				LastName:     to.Ptr("bar"),
			},
		},
		&armapimanagement.UserClientCreateOrUpdateOptions{Notify: nil,
			IfMatch: nil,
		})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// TODO: use response item
	_ = res
}

Read this SDK documentation on how to add the SDK to your project and authenticate.

Sample Response

Status code:: 201

{
  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512288c680b",
  "type": "Microsoft.ApiManagement/service/users",
  "name": "5931a75ae4bbd512288c680b",
  "properties": {
    "firstName": "foo",
    "lastName": "bar",
    "email": "foobar@outlook.com",
    "state": "active",
    "registrationDate": "2018-01-07T21:21:29.16Z",
    "groups": [],
    "identities": [
      {
        "provider": "Basic",
        "id": "foobar@outlook.com"
      }
    ]
  }
}

Status code:: 200

{
  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/5931a75ae4bbd512288c680b",
  "type": "Microsoft.ApiManagement/service/users",
  "name": "5931a75ae4bbd512288c680b",
  "properties": {
    "firstName": "foo",
    "lastName": "bar",
    "email": "foobar@outlook.com",
    "state": "active",
    "registrationDate": "2018-01-07T21:21:29.16Z",
    "groups": [],
    "identities": [
      {
        "provider": "Basic",
        "id": "foobar@outlook.com"
      }
    ]
  }
}

Definisi

AppType	Menentukan jenis aplikasi yang mengirim permintaan buat pengguna. Defaultnya adalah portal warisan.
Confirmation	Menentukan jenis email konfirmasi yang akan dikirim ke pengguna yang baru dibuat.
ErrorFieldContract	Kontrak Bidang Kesalahan.
ErrorResponse	Respons Kesalahan.
GroupContractProperties	Properti kontrak grup.
GroupType	Jenis grup.
UserContract	Detail pengguna.
UserCreateParameters	Detail pembuatan pengguna.
UserIdentityContract	Detail identitas pengguna.
UserState	Status akun. Menentukan apakah pengguna aktif atau tidak. Pengguna yang diblokir tidak dapat masuk ke portal pengembang atau memanggil API apa pun dari produk langganan. Status default adalah Aktif.

AppType

Menentukan jenis aplikasi yang mengirim permintaan buat pengguna. Defaultnya adalah portal warisan.

Name	Type	Description
developerPortal	string	Permintaan pembuatan pengguna dikirim oleh portal pengembang baru.
portal	string	Permintaan pembuatan pengguna dikirim oleh portal pengembang warisan.

Confirmation

Menentukan jenis email konfirmasi yang akan dikirim ke pengguna yang baru dibuat.

Name	Type	Description
invite	string	Kirim email yang mengundang pengguna untuk mendaftar dan menyelesaikan pendaftaran.
signup	string	Kirim email ke pengguna yang mengonfirmasi bahwa mereka telah berhasil mendaftar.

ErrorFieldContract

Kontrak Bidang Kesalahan.

Name	Type	Description
code	string	Kode kesalahan tingkat properti.
message	string	Representasi kesalahan tingkat properti yang dapat dibaca manusia.
target	string	Nama properti.

ErrorResponse

Respons Kesalahan.

Name	Type	Description
error.code	string	Kode kesalahan yang ditentukan layanan. Kode ini berfungsi sebagai sub-status untuk kode kesalahan HTTP yang ditentukan dalam respons.
error.details	ErrorFieldContract[]	Daftar bidang yang tidak valid dikirim dalam permintaan, jika terjadi kesalahan validasi.
error.message	string	Representasi kesalahan yang dapat dibaca manusia.

GroupContractProperties

Properti kontrak grup.

Name	Type	Description
builtIn	boolean	true jika grup adalah salah satu dari tiga grup sistem (Administrator, Pengembang, atau Tamu); jika tidak salah.
description	string	Deskripsi grup. Dapat berisi tag pemformatan HTML.
displayName	string	Nama grup.
externalId	string	Untuk grup eksternal, properti ini berisi id grup dari penyedia identitas eksternal, misalnya untuk Azure Active Directory `aad://<tenant>.onmicrosoft.com/groups/<group object id>`; jika tidak, nilainya null.
type	GroupType	Jenis grup.

GroupType

Jenis grup.

Name	Type	Description
custom	string
external	string
system	string

UserContract

Detail pengguna.

Name	Type	Default Value	Description
id	string		ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string		Nama sumber daya.
properties.email	string		Alamat Email.
properties.firstName	string		Nama depan.
properties.groups	GroupContractProperties[]		Kumpulan pengguna grup adalah bagian dari.
properties.identities	UserIdentityContract[]		Kumpulan identitas pengguna.
properties.lastName	string		Nama belakang.
properties.note	string		Catatan opsional tentang pengguna yang ditetapkan oleh administrator.
properties.registrationDate	string		Tanggal pendaftaran pengguna. Tanggal sesuai dengan format berikut: `yyyy-MM-ddTHH:mm:ssZ` seperti yang ditentukan oleh standar ISO 8601.
properties.state	UserState	active	Status akun. Menentukan apakah pengguna aktif atau tidak. Pengguna yang diblokir tidak dapat masuk ke portal pengembang atau memanggil API apa pun dari produk langganan. Status default adalah Aktif.
type	string		Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft. Storage/storageAccounts"

UserCreateParameters

Detail pembuatan pengguna.

Name	Type	Default Value	Description
properties.appType	AppType		Menentukan jenis aplikasi yang mengirim permintaan buat pengguna. Defaultnya adalah portal warisan.
properties.confirmation	Confirmation		Menentukan jenis email konfirmasi yang akan dikirim ke pengguna yang baru dibuat.
properties.email	string		Alamat Email. Tidak boleh kosong dan harus unik dalam instans layanan.
properties.firstName	string		Nama depan.
properties.identities	UserIdentityContract[]		Kumpulan identitas pengguna.
properties.lastName	string		Nama belakang.
properties.note	string		Catatan opsional tentang pengguna yang ditetapkan oleh administrator.
properties.password	string		Kata Sandi Pengguna. Jika tidak ada nilai yang disediakan, kata sandi default akan dibuat.
properties.state	UserState	active	Status akun. Menentukan apakah pengguna aktif atau tidak. Pengguna yang diblokir tidak dapat masuk ke portal pengembang atau memanggil API apa pun dari produk langganan. Status default adalah Aktif.

UserIdentityContract

Detail identitas pengguna.

Name	Type	Description
id	string	Nilai pengidentifikasi dalam penyedia.
provider	string	Nama Penyedia Identitas.

UserState

Status akun. Menentukan apakah pengguna aktif atau tidak. Pengguna yang diblokir tidak dapat masuk ke portal pengembang atau memanggil API apa pun dari produk langganan. Status default adalah Aktif.

Name	Type	Description
active	string	Status pengguna aktif.
blocked	string	Pengguna diblokir. Pengguna yang diblokir tidak dapat mengautentikasi di portal pengembang atau memanggil API.
deleted	string	Akun pengguna ditutup. Semua identitas dan entitas terkait dihapus.
pending	string	Akun pengguna tertunda. Memerlukan konfirmasi identitas sebelum dapat dibuat aktif.