Condividi tramite


Role Assignment Schedule Requests - Create

Crea una richiesta di pianificazione dell'assegnazione di ruolo.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
roleAssignmentScheduleRequestName
path True

string

GUID per l'assegnazione di ruolo da creare. Il nome deve essere univoco e diverso per ogni assegnazione di ruolo.

scope
path True

string

Ambito della richiesta di pianificazione dell'assegnazione di ruolo da creare. L'ambito può essere qualsiasi istanza di risorsa REST. Ad esempio, usare '/subscriptions/{subscription-id}/' per una sottoscrizione, '/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}' per un gruppo di risorse e '/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/{resource-provider}/{resource-type}/{resource-name}' per una risorsa.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
properties.principalId True

string

ID principale.

properties.requestType True

RequestType

Tipo della richiesta di pianificazione dell'assegnazione del ruolo. Ad esempio: SelfActivate, AdminAssign ecc

properties.roleDefinitionId True

string

ID definizione del ruolo.

properties.condition

string

Condizioni sull'assegnazione di ruolo. Ciò limita le risorse a cui può essere assegnato. Ad esempio: @Resource[Microsoft.Storage/storageAccounts/BLOBServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versione della condizione. Il valore attualmente accettato è '2.0'

properties.justification

string

Giustificazione per l'assegnazione di ruolo

properties.linkedRoleEligibilityScheduleId

string

ID pianificazione di idoneità del ruolo collegato: per attivare un'idoneità.

properties.scheduleInfo

ScheduleInfo

Pianificare le informazioni della pianificazione dell'assegnazione dei ruoli

properties.targetRoleAssignmentScheduleId

string

ID pianificazione dell'assegnazione dei ruoli risultante o id della pianificazione dell'assegnazione del ruolo da aggiornare

properties.targetRoleAssignmentScheduleInstanceId

string

ID dell'istanza dell'assegnazione del ruolo da aggiornare

properties.ticketInfo

TicketInfo

Informazioni sul ticket dell'assegnazione di ruolo

Risposte

Nome Tipo Descrizione
201 Created

RoleAssignmentScheduleRequest

Creato: restituisce informazioni sull'assegnazione di ruolo.

Other Status Codes

CloudError

Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

PutRoleAssignmentScheduleRequest

Esempio di richiesta

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"
  }
}

Risposta di esempio

{
  "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"
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

ExpandedProperties
Expiration

Scadenza della pianificazione dell'assegnazione del ruolo

Principal

Dettagli dell'entità

principalType

Tipo principale dell'ID entità assegnato.

RequestType

Tipo della richiesta di pianificazione dell'assegnazione del ruolo. Ad esempio: SelfActivate, AdminAssign ecc

RoleAssignmentScheduleRequest

Richiesta di pianificazione dell'assegnazione dei ruoli

RoleDefinition

Dettagli della definizione del ruolo

ScheduleInfo

Pianificare le informazioni della pianificazione dell'assegnazione dei ruoli

Scope

Dettagli dell'ambito della risorsa

Status

Stato della richiesta di pianificazione dell'assegnazione del ruolo.

TicketInfo

Informazioni sul ticket dell'assegnazione di ruolo

Type

Tipo della scadenza della pianificazione dell'assegnazione del ruolo

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Risposta di errore dal servizio.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere usati a livello di codice.

message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.

ExpandedProperties

Nome Tipo Descrizione
principal

Principal

Dettagli dell'entità

roleDefinition

RoleDefinition

Dettagli della definizione del ruolo

scope

Scope

Dettagli dell'ambito della risorsa

Expiration

Scadenza della pianificazione dell'assegnazione del ruolo

Nome Tipo Descrizione
duration

string

Durata della pianificazione dell'assegnazione di ruolo in TimeSpan.

endDateTime

string

Fine DateTime della pianificazione dell'assegnazione di ruolo.

type

Type

Tipo della scadenza della pianificazione dell'assegnazione del ruolo

Principal

Dettagli dell'entità

Nome Tipo Descrizione
displayName

string

Nome visualizzato dell'entità

email

string

Email id dell'entità

id

string

ID dell'entità

type

string

Tipo dell'entità

principalType

Tipo principale dell'ID entità assegnato.

Nome Tipo Descrizione
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RequestType

Tipo della richiesta di pianificazione dell'assegnazione del ruolo. Ad esempio: SelfActivate, AdminAssign ecc

Nome Tipo Descrizione
AdminAssign

string

AdminExtend

string

AdminRemove

string

AdminRenew

string

AdminUpdate

string

SelfActivate

string

SelfDeactivate

string

SelfExtend

string

SelfRenew

string

RoleAssignmentScheduleRequest

Richiesta di pianificazione dell'assegnazione dei ruoli

Nome Tipo Descrizione
id

string

ID richiesta di pianificazione dell'assegnazione del ruolo.

name

string

Nome della richiesta di pianificazione dell'assegnazione del ruolo.

properties.approvalId

string

Id di approvazione della richiesta di pianificazione dell'assegnazione del ruolo.

properties.condition

string

Condizioni sull'assegnazione di ruolo. Ciò limita le risorse a cui può essere assegnato. Ad esempio: @Resource[Microsoft.Storage/storageAccounts/BLOBServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versione della condizione. Il valore attualmente accettato è '2.0'

properties.createdOn

string

DateTime quando è stata creata la richiesta di pianificazione dell'assegnazione dei ruoli

properties.expandedProperties

ExpandedProperties

Proprietà aggiuntive di entità, ambito e definizione del ruolo

properties.justification

string

Giustificazione per l'assegnazione di ruolo

properties.linkedRoleEligibilityScheduleId

string

ID pianificazione di idoneità del ruolo collegato: per attivare un'idoneità.

properties.principalId

string

ID principale.

properties.principalType

principalType

Tipo principale dell'ID entità assegnato.

properties.requestType

RequestType

Tipo della richiesta di pianificazione dell'assegnazione del ruolo. Ad esempio: SelfActivate, AdminAssign ecc

properties.requestorId

string

ID dell'utente che ha creato questa richiesta

properties.roleDefinitionId

string

ID definizione del ruolo.

properties.scheduleInfo

ScheduleInfo

Pianificare le informazioni della pianificazione dell'assegnazione dei ruoli

properties.scope

string

Ambito della richiesta di pianificazione dell'assegnazione del ruolo.

properties.status

Status

Stato della richiesta di pianificazione dell'assegnazione del ruolo.

properties.targetRoleAssignmentScheduleId

string

ID pianificazione dell'assegnazione dei ruoli risultante o id della pianificazione dell'assegnazione del ruolo da aggiornare

properties.targetRoleAssignmentScheduleInstanceId

string

ID dell'istanza dell'assegnazione del ruolo da aggiornare

properties.ticketInfo

TicketInfo

Informazioni sul ticket dell'assegnazione di ruolo

type

string

Tipo di richiesta di pianificazione dell'assegnazione del ruolo.

RoleDefinition

Dettagli della definizione del ruolo

Nome Tipo Descrizione
displayName

string

Nome visualizzato della definizione del ruolo

id

string

ID della definizione del ruolo

type

string

Tipo della definizione del ruolo

ScheduleInfo

Pianificare le informazioni della pianificazione dell'assegnazione dei ruoli

Nome Tipo Descrizione
expiration

Expiration

Scadenza della pianificazione dell'assegnazione del ruolo

startDateTime

string

Avviare DateTime della pianificazione dell'assegnazione del ruolo.

Scope

Dettagli dell'ambito della risorsa

Nome Tipo Descrizione
displayName

string

Nome visualizzato della risorsa

id

string

ID ambito della risorsa

type

string

Tipo della risorsa

Status

Stato della richiesta di pianificazione dell'assegnazione del ruolo.

Nome Tipo Descrizione
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

Informazioni sul ticket dell'assegnazione di ruolo

Nome Tipo Descrizione
ticketNumber

string

Numero di ticket per l'assegnazione di ruolo

ticketSystem

string

Nome del sistema di ticket per l'assegnazione di ruolo

Type

Tipo della scadenza della pianificazione dell'assegnazione del ruolo

Nome Tipo Descrizione
AfterDateTime

string

AfterDuration

string

NoExpiration

string