Role Assignment Schedule Requests - Create

Tworzy żądanie harmonogramu przypisania roli.

PUT https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignmentScheduleRequests/{roleAssignmentScheduleRequestName}?api-version=2020-10-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
roleAssignmentScheduleRequestName
path True

string

Identyfikator GUID przypisania roli do utworzenia. Nazwa musi być unikatowa i inna dla każdego przypisania roli.

scope
path True

string

Zakres żądania harmonogramu przypisania roli do utworzenia. Zakres może być dowolnym wystąpieniem zasobu REST. Na przykład użyj wartości "/subscriptions/{subscription-id}/" dla subskrypcji , "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}" dla grupy zasobów i "/subscriptions/{subscriptions/{subscription-id}/resourceGroups/{resource-name}/providers/{resource-provider}/{resource-type}/{nazwa-zasobu}/{nazwa-zasobu}" dla zasobu.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
properties.principalId True

string

Identyfikator podmiotu zabezpieczeń.

properties.requestType True

RequestType

Typ żądania harmonogramu przypisania roli. Na przykład: SelfActivate, AdminAssign itp.

properties.roleDefinitionId True

string

Identyfikator definicji roli.

properties.condition

string

Warunki przypisania roli. Ogranicza to zasoby, do których można przypisać te zasoby. np. @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

Wersja warunku. Obecnie akceptowana wartość to "2.0"

properties.justification

string

Uzasadnienie przypisania roli

properties.linkedRoleEligibilityScheduleId

string

Identyfikator harmonogramu uprawnień do połączonej roli — aby aktywować uprawnienia.

properties.scheduleInfo

ScheduleInfo

Planowanie informacji o harmonogramie przypisania roli

properties.targetRoleAssignmentScheduleId

string

Wynikowy identyfikator harmonogramu przypisania roli lub identyfikator harmonogramu przypisania roli jest aktualizowany

properties.targetRoleAssignmentScheduleInstanceId

string

Identyfikator wystąpienia harmonogramu przypisania roli jest aktualizowany

properties.ticketInfo

TicketInfo

Informacje o biletach przypisania roli

Odpowiedzi

Nazwa Typ Opis
201 Created

RoleAssignmentScheduleRequest

Utworzone — zwraca informacje o przypisaniu roli.

Other Status Codes

CloudError

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

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

PutRoleAssignmentScheduleRequest

Sample Request

PUT https://management.azure.com/providers/Microsoft.Subscription/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleAssignmentScheduleRequests/fea7a502-9a96-4806-a26f-eee560e52045?api-version=2020-10-01

{
  "properties": {
    "principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
    "requestType": "SelfActivate",
    "linkedRoleEligibilityScheduleId": "b1477448-2cc6-4ceb-93b4-54a202a89413",
    "scheduleInfo": {
      "startDateTime": "2020-09-09T21:35:27.91Z",
      "expiration": {
        "type": "AfterDuration",
        "endDateTime": null,
        "duration": "PT8H"
      }
    },
    "condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
    "conditionVersion": "1.0"
  }
}

Sample Response

{
  "properties": {
    "targetRoleAssignmentScheduleId": "c9e264ff-3133-4776-a81a-ebc7c33c8ec6",
    "targetRoleAssignmentScheduleInstanceId": null,
    "scope": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
    "roleDefinitionId": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
    "principalId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "principalType": "User",
    "requestType": "SelfActivate",
    "status": "Provisioned",
    "approvalId": null,
    "scheduleInfo": {
      "startDateTime": "2020-09-09T21:35:27.91Z",
      "expiration": {
        "type": "AfterDuration",
        "endDateTime": null,
        "duration": "PT8H"
      }
    },
    "ticketInfo": {
      "ticketNumber": null,
      "ticketSystem": null
    },
    "justification": null,
    "requestorId": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
    "createdOn": "2020-09-09T21:35:27.91Z",
    "condition": "@Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'",
    "conditionVersion": "1.0",
    "expandedProperties": {
      "scope": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f",
        "displayName": "Pay-As-You-Go",
        "type": "subscription"
      },
      "roleDefinition": {
        "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/roleDefinitions/c8d4ff99-41c3-41a8-9f60-21dfdad59608",
        "displayName": "Contributor",
        "type": "BuiltInRole"
      },
      "principal": {
        "id": "a3bb8764-cb92-4276-9d2a-ca1e895e55ea",
        "displayName": "User Account",
        "email": "user@my-tenant.com",
        "type": "User"
      }
    }
  },
  "name": "fea7a502-9a96-4806-a26f-eee560e52045",
  "id": "/subscriptions/dfa2a084-766f-4003-8ae1-c4aeb893a99f/providers/Microsoft.Authorization/RoleAssignmentScheduleRequests/fea7a502-9a96-4806-a26f-eee560e52045",
  "type": "Microsoft.Authorization/RoleAssignmentScheduleRequests"
}

Definicje

Nazwa Opis
CloudError

Odpowiedź błędu z usługi.

CloudErrorBody

Odpowiedź błędu z usługi.

ExpandedProperties
Expiration

Wygaśnięcie harmonogramu przypisania roli

Principal

Szczegóły podmiotu zabezpieczeń

principalType

Typ podmiotu zabezpieczeń przypisanego identyfikatora podmiotu zabezpieczeń.

RequestType

Typ żądania harmonogramu przypisania roli. Na przykład: SelfActivate, AdminAssign itp.

RoleAssignmentScheduleRequest

Żądanie harmonogramu przypisania roli

RoleDefinition

Szczegóły definicji roli

ScheduleInfo

Planowanie informacji o harmonogramie przypisania roli

Scope

Szczegóły zakresu zasobów

Status

Stan żądania harmonogramu przypisania roli.

TicketInfo

Informacje o biletach przypisania roli

Type

Typ wygasania harmonogramu przypisania roli

CloudError

Odpowiedź błędu z usługi.

Nazwa Typ Opis
error

CloudErrorBody

Odpowiedź błędu z usługi.

CloudErrorBody

Odpowiedź błędu z usługi.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

ExpandedProperties

Nazwa Typ Opis
principal

Principal

Szczegóły podmiotu zabezpieczeń

roleDefinition

RoleDefinition

Szczegóły definicji roli

scope

Scope

Szczegóły zakresu zasobów

Expiration

Wygaśnięcie harmonogramu przypisania roli

Nazwa Typ Opis
duration

string

Czas trwania harmonogramu przypisania roli w przedziałie czasu.

endDateTime

string

Koniec daty/godziny harmonogramu przypisania roli.

type

Type

Typ wygasania harmonogramu przypisania roli

Principal

Szczegóły podmiotu zabezpieczeń

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń

email

string

Email identyfikator podmiotu zabezpieczeń

id

string

Identyfikator podmiotu zabezpieczeń

type

string

Typ podmiotu zabezpieczeń

principalType

Typ podmiotu zabezpieczeń przypisanego identyfikatora podmiotu zabezpieczeń.

Nazwa Typ Opis
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RequestType

Typ żądania harmonogramu przypisania roli. Na przykład: SelfActivate, AdminAssign itp.

Nazwa Typ Opis
AdminAssign

string

AdminExtend

string

AdminRemove

string

AdminRenew

string

AdminUpdate

string

SelfActivate

string

SelfDeactivate

string

SelfExtend

string

SelfRenew

string

RoleAssignmentScheduleRequest

Żądanie harmonogramu przypisania roli

Nazwa Typ Opis
id

string

Identyfikator żądania harmonogramu przypisania roli.

name

string

Nazwa żądania harmonogramu przypisania roli.

properties.approvalId

string

Identyfikator zatwierdzenia żądania harmonogramu przypisania roli.

properties.condition

string

Warunki przypisania roli. Ogranicza to zasoby, do których można przypisać te zasoby. np. @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase "foo_storage_container"

properties.conditionVersion

string

Wersja warunku. Obecnie akceptowana wartość to "2.0"

properties.createdOn

string

Data/godzina utworzenia żądania harmonogramu przypisania roli

properties.expandedProperties

ExpandedProperties

Dodatkowe właściwości jednostki, zakresu i definicji roli

properties.justification

string

Uzasadnienie przypisania roli

properties.linkedRoleEligibilityScheduleId

string

Identyfikator harmonogramu uprawnień do połączonej roli — aby aktywować uprawnienia.

properties.principalId

string

Identyfikator podmiotu zabezpieczeń.

properties.principalType

principalType

Typ podmiotu zabezpieczeń przypisanego identyfikatora podmiotu zabezpieczeń.

properties.requestType

RequestType

Typ żądania harmonogramu przypisania roli. Na przykład: SelfActivate, AdminAssign itp.

properties.requestorId

string

Identyfikator użytkownika, który utworzył to żądanie

properties.roleDefinitionId

string

Identyfikator definicji roli.

properties.scheduleInfo

ScheduleInfo

Planowanie informacji o harmonogramie przypisania roli

properties.scope

string

Zakres żądania harmonogramu przypisania roli.

properties.status

Status

Stan żądania harmonogramu przypisania roli.

properties.targetRoleAssignmentScheduleId

string

Wynikowy identyfikator harmonogramu przypisania roli lub identyfikator harmonogramu przypisania roli jest aktualizowany

properties.targetRoleAssignmentScheduleInstanceId

string

Identyfikator wystąpienia harmonogramu przypisania roli jest aktualizowany

properties.ticketInfo

TicketInfo

Informacje o biletach przypisania roli

type

string

Typ żądania harmonogramu przypisania roli.

RoleDefinition

Szczegóły definicji roli

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana definicji roli

id

string

Identyfikator definicji roli

type

string

Typ definicji roli

ScheduleInfo

Planowanie informacji o harmonogramie przypisania roli

Nazwa Typ Opis
expiration

Expiration

Wygaśnięcie harmonogramu przypisania roli

startDateTime

string

Początek daty/godziny harmonogramu przypisania roli.

Scope

Szczegóły zakresu zasobów

Nazwa Typ Opis
displayName

string

Nazwa wyświetlana zasobu

id

string

Identyfikator zakresu zasobu

type

string

Typ zasobu

Status

Stan żądania harmonogramu przypisania roli.

Nazwa Typ Opis
Accepted

string

AdminApproved

string

AdminDenied

string

Canceled

string

Denied

string

Failed

string

FailedAsResourceIsLocked

string

Granted

string

Invalid

string

PendingAdminDecision

string

PendingApproval

string

PendingApprovalProvisioning

string

PendingEvaluation

string

PendingExternalProvisioning

string

PendingProvisioning

string

PendingRevocation

string

PendingScheduleCreation

string

Provisioned

string

ProvisioningStarted

string

Revoked

string

ScheduleCreated

string

TimedOut

string

TicketInfo

Informacje o biletach przypisania roli

Nazwa Typ Opis
ticketNumber

string

Numer biletu dla przypisania roli

ticketSystem

string

Nazwa systemu biletów dla przypisania roli

Type

Typ wygasania harmonogramu przypisania roli

Nazwa Typ Opis
AfterDateTime

string

AfterDuration

string

NoExpiration

string