Compartilhar via

Criar fileStorageContainerTypeRegistration

Namespace: microsoft.graph

Crie ou substitua um objeto fileStorageContainerTypeRegistration . Este método regista um fileStorageContainerType no inquilino.

Para os contentores padrão, a faturação tem de ser válida para que o registo seja concluído com êxito.

Importante

  • Uma aplicação só pode registar um fileStorageContainerType que possui, utilizando tokens apenas de aplicação ou delegados.
  • O registo de um tipo de contentor num inquilino recentemente criado pode falhar se o inquilino ainda não estiver totalmente pronto. Poderá ter de esperar pelo menos uma hora para poder registar um tipo de contentor num novo inquilino.

As definições não podem ser modificadas durante o registo.

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissão com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) FileStorageContainerTypeReg.Selected FileStorageContainerTypeReg.Manage.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application FileStorageContainerTypeReg.Selected Indisponível.

Observação:

  • Quando são utilizados tokens delegados, é necessária a função de administrador do SharePoint Embedded ou a função de Administrador global.
  • O registo tem de ser feito no contexto da aplicação que detém o fileStorageContainerType.

Solicitação HTTP

Para registar um fileStorageContainerType no inquilino atual.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}

Nota: Utilize o método PUT. Este pedido cria um objeto fileStorageContainertypeRegistration com o ID fornecido (fileStorageContainerTypeId).

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON do objeto fileStorageContainerTypeRegistration .

Pode especificar a seguinte propriedade quando criar um ficheiroStorageContainerTypeRegistration.

Propriedade Tipo Descrição
applicationPermissionGrants fileStorageContainerTypeAppPermissionGrant collection (Coleção fileStorageContainerTypeAppPermissionGrant) Os privilégios de acesso de aplicações em contentores de um ficheiro específicoStorageContainerType. Opcional.

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto fileStorageContainerTypeRegistration no corpo da resposta.

Exemplos

Exemplo 1: Criar um ficheiroStorageContainerTypeRegistration para um ficheiro de avaliaçãoStorageContainerType

O exemplo seguinte mostra como criar um ficheiroStorageContainerTypeRegistration para um ficheiro de avaliaçãoStorageContainerType com alguns applicationPermissionGrants.

Solicitação

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileStorageContainerTypeRegistration",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Test Trial Container",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "registeredDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZw==",
  "settings": {
    "@odata.type": "microsoft.graph.fileStorageContainerTypeRegistrationSettings",
    "sharingCapability": "disabled",
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": true,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Exemplo 2: Criar um ficheiroStorageContainerTypeRegistration para um fileStorageContainerType padrão em que a configuração de faturação não está concluída

O exemplo seguinte mostra como criar um ficheiroStorageContainerTypeRegistration para um fileStorageContainerType padrão onde a configuração de faturação não está concluída.

Solicitação

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/52a2630c-5e6a-41ff-8645-15406bafe66a
Content-Type: application/json

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    }
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 405 Method Not Allowed
  • Last updated on