Criar fileStorageContainerTypeRegistration

Namespace: microsoft.graph

Crie ou substitua um objeto fileStorageContainerTypeRegistration . Esse método registra um fileStorageContainerType no locatário.

Para contêineres padrão, a cobrança deve ser válida para que o registro seja concluído com êxito.

Importante

  • Um aplicativo só pode registrar um fileStorageContainerType de sua propriedade, usando tokens somente de aplicativo ou delegados.
  • O registro de um tipo de contêiner em um locatário recém-criado poderá falhar se o locatário ainda não estiver totalmente pronto. Talvez seja necessário aguardar pelo menos uma hora antes de registrar um tipo de contêiner em um novo locatário.

As configurações não podem ser modificadas durante o registro.

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissão com privilégios mínimos Permissões com privilégios mais elevados
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 tokens delegados são usados, a função de administrador incorporado do SharePoint ou a função de administrador global é necessária.
  • O registro deve ser feito no contexto do aplicativo que possui o fileStorageContainerType.

Solicitação HTTP

Para registrar um fileStorageContainerType no locatário atual.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}

Observação: Use o método PUT. Essa solicitação cria um objeto fileStorageContainertypeRegistration com a ID fornecida (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 da solicitação, forneça uma representação JSON do objeto fileStorageContainerTypeRegistration .

Você pode especificar a propriedade a seguir ao criar um fileStorageContainerTypeRegistration.

Propriedade Tipo Descrição
applicationPermissionGrants coleção fileStorageContainerTypeAppPermissionGrant Os privilégios de acesso de aplicativos em contêineres de um fileStorageContainerType específico. Opcional.

Resposta

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

Exemplos

Exemplo 1: Criar um fileStorageContainerTypeRegistration para um fileStorageContainerType de avaliação

O exemplo a seguir mostra como criar um fileStorageContainerTypeRegistration para um fileStorageContainerType de avaliação 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 fileStorageContainerTypeRegistration para um fileStorageContainerType padrão em que a configuração de cobrança não foi concluída

O exemplo a seguir mostra como criar um fileStorageContainerTypeRegistration para um fileStorageContainerType padrão em que a configuração de cobrança não foi 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