Udostępnij za pośrednictwem


Enrollment Department Role Assignments - Put

Utwórz lub zaktualizuj przypisanie roli rozliczeń.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
billingAccountName
path True

string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

billingRoleAssignmentName
path True

string

Identyfikator, który jednoznacznie identyfikuje przypisanie roli.

departmentName
path True

string

Identyfikator, który jednoznacznie identyfikuje dział.

api-version
query True

string

Wersja interfejsu API, która ma być używana z żądaniem klienta. Bieżąca wersja to 2019-10-01-preview.

Treść żądania

Nazwa Typ Opis
properties.principalId

string

Identyfikator podmiotu zabezpieczeń użytkownika, któremu przypisano rolę.

properties.principalTenantId

string

Identyfikator dzierżawy podmiotu zabezpieczeń użytkownika, któremu przypisano rolę.

properties.roleDefinitionId

string

Identyfikator definicji roli.

properties.userAuthenticationType

string

Typ uwierzytelniania użytkownika, niezależnie od tego, czy jest to organizacja, czy MSA, do którego przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement.

properties.userEmailAddress

string

Adres e-mail użytkownika, któremu przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement.

Odpowiedzi

Nazwa Typ Opis
200 OK

BillingRoleAssignment

OK. Żądanie zakończyło się pomyślnie.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

PutEnrollmentDepartmentAdministratorRoleAssignment

Przykładowe żądanie

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/departments/{departmentName}/billingRoleAssignments/{billingRoleAssignmentName}?api-version=2019-10-01-preview

{
  "properties": {
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/97603/billingRoleDefinitions/fb2cf67f-be5b-42e7-8025-4683c668f840"
  }
}

Przykładowa odpowiedź

{
  "id": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/97603/billingRoleAssignments/9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "name": "9dfd08c2-62a3-4d47-85bd-1cdba1408402",
  "properties": {
    "createdOn": "2019-06-28T19:11:50.6168809+00:00",
    "createdByPrincipalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "createdByPrincipalId": "60d97094-2be4-46cc-a4fe-3633021a25b9",
    "principalId": "99a1a759-30dd-42c2-828c-db398826bb67",
    "principalTenantId": "7ca289b9-c32d-4f01-8566-7ff93261d76f",
    "roleDefinitionId": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/97603/billingRoleDefinitions/fb2cf67f-be5b-42e7-8025-4683c668f840",
    "scope": "/providers/Microsoft.Billing/billingAccounts/7898901/departments/97603"
  },
  "type": "Microsoft.Billing/billingAccounts/departments/billingRoleAssignments"
}

Definicje

Nazwa Opis
BillingRoleAssignment

Przypisanie roli

ErrorDetails

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

ErrorSubDetails

BillingRoleAssignment

Przypisanie roli

Nazwa Typ Opis
id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.createdByPrincipalId

string

Identyfikator podmiotu zabezpieczeń użytkownika, który utworzył przypisanie roli.

properties.createdByPrincipalTenantId

string

Identyfikator dzierżawy użytkownika, który utworzył przypisanie roli.

properties.createdByUserEmailAddress

string

Adres e-mail użytkownika, który utworzył przypisanie roli. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement.

properties.createdOn

string

Data utworzenia przypisania roli.

properties.name

string

Nazwa przypisania roli.

properties.principalId

string

Identyfikator podmiotu zabezpieczeń użytkownika, któremu przypisano rolę.

properties.principalTenantId

string

Identyfikator dzierżawy podmiotu zabezpieczeń użytkownika, któremu przypisano rolę.

properties.roleDefinitionId

string

Identyfikator definicji roli.

properties.scope

string

Zakres, do którego przypisano rolę.

properties.userAuthenticationType

string

Typ uwierzytelniania użytkownika, niezależnie od tego, czy jest to organizacja, czy MSA, do którego przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement.

properties.userEmailAddress

string

Adres e-mail użytkownika, któremu przypisano rolę. Jest to obsługiwane tylko w przypadku kont rozliczeniowych z typem umowy Enterprise Agreement.

type

string

Typ zasobu.

ErrorDetails

Szczegóły błędu.

Nazwa Typ Opis
code

string

Kod błędu.

details

ErrorSubDetails[]

Szczegóły podrzędne błędu.

message

string

Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

target

string

Element docelowy określonego błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa Typ Opis
error

ErrorDetails

Szczegóły błędu.

ErrorSubDetails

Nazwa Typ Opis
code

string

Kod błędu.

message

string

Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

target

string

Element docelowy określonego błędu.