Csoportot hoz létre vagy Frissítések.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/groups/{groupId}?api-version=2022-08-01
URI-paraméterek
Name |
In |
Kötelező |
Típus |
Description |
groupId
|
path |
True
|
string
|
Csoportazonosító. Az aktuális API Management szolgáltatáspéldányban egyedinek kell lennie.
|
resourceGroupName
|
path |
True
|
string
|
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.
|
serviceName
|
path |
True
|
string
|
A API Management szolgáltatás neve.
Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
|
subscriptionId
|
path |
True
|
string
|
A cél-előfizetés azonosítója.
|
api-version
|
query |
True
|
string
|
A művelethez használandó API-verzió.
|
Name |
Kötelező |
Típus |
Description |
If-Match
|
|
string
|
Az entitás ETagje. Entitás létrehozásakor nem kötelező, de az entitások frissítésekor kötelező.
|
Kérelem törzse
Name |
Kötelező |
Típus |
Description |
properties.displayName
|
True
|
string
|
Csoport neve.
|
properties.description
|
|
string
|
Csoport leírása.
|
properties.externalId
|
|
string
|
A külső csoportok azonosítója, ez a tulajdonság a külső identitásszolgáltatótól származó csoport azonosítóját tartalmazza, például az Azure Active Directory aad://<tenant>.onmicrosoft.com/groups/<group object id> esetében; ellenkező esetben az érték null.
|
properties.type
|
|
GroupType
|
Csoport típusa.
|
Válaszok
Name |
Típus |
Description |
200 OK
|
GroupContract
|
A csoport már létezik.
Headers
ETag: string
|
201 Created
|
GroupContract
|
A csoport létrehozása sikerült.
Headers
ETag: string
|
Other Status Codes
|
ErrorResponse
|
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg.
|
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name |
Description |
user_impersonation
|
felhasználói fiók megszemélyesítése
|
Példák
ApiManagementCreateGroup
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup?api-version=2022-08-01
{
"properties": {
"displayName": "temp group"
}
}
/** Samples for Group CreateOrUpdate. */
public final class Main {
/*
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroup.json
*/
/**
* Sample code: ApiManagementCreateGroup.
*
* @param manager Entry point to ApiManagementManager.
*/
public static void apiManagementCreateGroup(com.azure.resourcemanager.apimanagement.ApiManagementManager manager) {
manager
.groups()
.define("tempgroup")
.withExistingService("rg1", "apimService1")
.withDisplayName("temp group")
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from typing import Any, IO, Union
from azure.identity import DefaultAzureCredential
from azure.mgmt.apimanagement import ApiManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-apimanagement
# USAGE
python api_management_create_group.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ApiManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.group.create_or_update(
resource_group_name="rg1",
service_name="apimService1",
group_id="tempgroup",
parameters={"properties": {"displayName": "temp group"}},
)
print(response)
# x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroup.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
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/v2"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4cd95123fb961c68740565a1efcaa5e43bd35802/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroup.json
func ExampleGroupClient_CreateOrUpdate_apiManagementCreateGroup() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armapimanagement.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewGroupClient().CreateOrUpdate(ctx, "rg1", "apimService1", "tempgroup", armapimanagement.GroupCreateParameters{
Properties: &armapimanagement.GroupCreateParametersProperties{
DisplayName: to.Ptr("temp group"),
},
}, &armapimanagement.GroupClientCreateOrUpdateOptions{IfMatch: nil})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.GroupContract = armapimanagement.GroupContract{
// Name: to.Ptr("tempgroup"),
// Type: to.Ptr("Microsoft.ApiManagement/service/groups"),
// ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup"),
// Properties: &armapimanagement.GroupContractProperties{
// Type: to.Ptr(armapimanagement.GroupTypeCustom),
// DisplayName: to.Ptr("temp group"),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ApiManagementClient } = require("@azure/arm-apimanagement");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Creates or Updates a group.
*
* @summary Creates or Updates a group.
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroup.json
*/
async function apiManagementCreateGroup() {
const subscriptionId = process.env["APIMANAGEMENT_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["APIMANAGEMENT_RESOURCE_GROUP"] || "rg1";
const serviceName = "apimService1";
const groupId = "tempgroup";
const parameters = { displayName: "temp group" };
const credential = new DefaultAzureCredential();
const client = new ApiManagementClient(credential, subscriptionId);
const result = await client.group.createOrUpdate(
resourceGroupName,
serviceName,
groupId,
parameters
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup",
"type": "Microsoft.ApiManagement/service/groups",
"name": "tempgroup",
"properties": {
"displayName": "temp group",
"type": "custom"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup",
"type": "Microsoft.ApiManagement/service/groups",
"name": "tempgroup",
"properties": {
"displayName": "temp group",
"type": "custom"
}
}
ApiManagementCreateGroupExternal
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup?api-version=2022-08-01
{
"properties": {
"displayName": "NewGroup (samiraad.onmicrosoft.com)",
"description": "new group to test",
"type": "external",
"externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
}
}
import com.azure.resourcemanager.apimanagement.models.GroupType;
/** Samples for Group CreateOrUpdate. */
public final class Main {
/*
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroupExternal.json
*/
/**
* Sample code: ApiManagementCreateGroupExternal.
*
* @param manager Entry point to ApiManagementManager.
*/
public static void apiManagementCreateGroupExternal(
com.azure.resourcemanager.apimanagement.ApiManagementManager manager) {
manager
.groups()
.define("aadGroup")
.withExistingService("rg1", "apimService1")
.withDisplayName("NewGroup (samiraad.onmicrosoft.com)")
.withDescription("new group to test")
.withType(GroupType.EXTERNAL)
.withExternalId("aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d")
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from typing import Any, IO, Union
from azure.identity import DefaultAzureCredential
from azure.mgmt.apimanagement import ApiManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-apimanagement
# USAGE
python api_management_create_group_external.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ApiManagementClient(
credential=DefaultAzureCredential(),
subscription_id="subid",
)
response = client.group.create_or_update(
resource_group_name="rg1",
service_name="apimService1",
group_id="aadGroup",
parameters={
"properties": {
"description": "new group to test",
"displayName": "NewGroup (samiraad.onmicrosoft.com)",
"externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d",
"type": "external",
}
},
)
print(response)
# x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroupExternal.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
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/v2"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/4cd95123fb961c68740565a1efcaa5e43bd35802/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroupExternal.json
func ExampleGroupClient_CreateOrUpdate_apiManagementCreateGroupExternal() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armapimanagement.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
res, err := clientFactory.NewGroupClient().CreateOrUpdate(ctx, "rg1", "apimService1", "aadGroup", armapimanagement.GroupCreateParameters{
Properties: &armapimanagement.GroupCreateParametersProperties{
Type: to.Ptr(armapimanagement.GroupTypeExternal),
Description: to.Ptr("new group to test"),
DisplayName: to.Ptr("NewGroup (samiraad.onmicrosoft.com)"),
ExternalID: to.Ptr("aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"),
},
}, &armapimanagement.GroupClientCreateOrUpdateOptions{IfMatch: nil})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res.GroupContract = armapimanagement.GroupContract{
// Name: to.Ptr("aadGroup"),
// Type: to.Ptr("Microsoft.ApiManagement/service/groups"),
// ID: to.Ptr("/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup"),
// Properties: &armapimanagement.GroupContractProperties{
// Type: to.Ptr(armapimanagement.GroupTypeExternal),
// Description: to.Ptr("new group to test"),
// DisplayName: to.Ptr("NewGroup (samiraad.onmicrosoft.com)"),
// ExternalID: to.Ptr("aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"),
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ApiManagementClient } = require("@azure/arm-apimanagement");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Creates or Updates a group.
*
* @summary Creates or Updates a group.
* x-ms-original-file: specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2022-08-01/examples/ApiManagementCreateGroupExternal.json
*/
async function apiManagementCreateGroupExternal() {
const subscriptionId = process.env["APIMANAGEMENT_SUBSCRIPTION_ID"] || "subid";
const resourceGroupName = process.env["APIMANAGEMENT_RESOURCE_GROUP"] || "rg1";
const serviceName = "apimService1";
const groupId = "aadGroup";
const parameters = {
type: "external",
description: "new group to test",
displayName: "NewGroup (samiraad.onmicrosoft.com)",
externalId: "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d",
};
const credential = new DefaultAzureCredential();
const client = new ApiManagementClient(credential, subscriptionId);
const result = await client.group.createOrUpdate(
resourceGroupName,
serviceName,
groupId,
parameters
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup",
"type": "Microsoft.ApiManagement/service/groups",
"name": "aadGroup",
"properties": {
"displayName": "NewGroup (samiraad.onmicrosoft.com)",
"description": "new group to test",
"type": "external",
"externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/aadGroup",
"type": "Microsoft.ApiManagement/service/groups",
"name": "aadGroup",
"properties": {
"displayName": "NewGroup (samiraad.onmicrosoft.com)",
"description": "new group to test",
"type": "external",
"externalId": "aad://samiraad.onmicrosoft.com/groups/83cf2753-5831-4675-bc0e-2f8dc067c58d"
}
}
Definíciók
ErrorFieldContract
Hibamező-szerződés.
Name |
Típus |
Description |
code
|
string
|
Tulajdonságszintű hibakód.
|
message
|
string
|
A tulajdonságszintű hiba emberi olvasásra alkalmas ábrázolása.
|
target
|
string
|
Tulajdonság neve.
|
ErrorResponse
Hibaválasz.
Name |
Típus |
Description |
error.code
|
string
|
Szolgáltatás által definiált hibakód. Ez a kód a válaszban megadott HTTP-hibakód alállapotaként szolgál.
|
error.details
|
ErrorFieldContract[]
|
Érvényesítési hiba esetén a kérelemben küldött érvénytelen mezők listája.
|
error.message
|
string
|
A hiba emberi olvasásra alkalmas ábrázolása.
|
GroupContract
Szerződés részletei.
Name |
Típus |
Description |
id
|
string
|
Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
|
name
|
string
|
Az erőforrás neve
|
properties.builtIn
|
boolean
|
igaz, ha a csoport a három rendszercsoport egyike (rendszergazdák, fejlesztők vagy vendégek); egyéb esetben hamis.
|
properties.description
|
string
|
Csoport leírása. HTML-formázási címkéket tartalmazhat.
|
properties.displayName
|
string
|
Csoport neve.
|
properties.externalId
|
string
|
Külső csoportok esetén ez a tulajdonság a külső identitásszolgáltatótól származó csoport azonosítóját tartalmazza, például az Azure Active Directory aad://<tenant>.onmicrosoft.com/groups/<group object id> esetében; ellenkező esetben az érték null.
|
properties.type
|
GroupType
|
Csoport típusa.
|
type
|
string
|
Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"
|
GroupCreateParameters
A Csoport létrehozása művelethez megadott paraméterek.
Name |
Típus |
Description |
properties.description
|
string
|
Csoport leírása.
|
properties.displayName
|
string
|
Csoport neve.
|
properties.externalId
|
string
|
A külső csoportok azonosítója, ez a tulajdonság a külső identitásszolgáltatótól származó csoport azonosítóját tartalmazza, például az Azure Active Directory aad://<tenant>.onmicrosoft.com/groups/<group object id> esetében; ellenkező esetben az érték null.
|
properties.type
|
GroupType
|
Csoport típusa.
|
GroupType
Csoport típusa.
Name |
Típus |
Description |
custom
|
string
|
|
external
|
string
|
|
system
|
string
|
|