次の方法で共有

fileStorageContainerTypeRegistration を作成する

名前空間: microsoft.graph

fileStorageContainerTypeRegistration オブジェクトを作成または置換します。 このメソッドは、テナントに fileStorageContainerType を登録します。

標準コンテナーの場合、登録が正常に完了するには 、課金 が有効である必要があります。

重要

  • アプリケーションは、アプリ専用または委任されたトークンを使用して、所有する fileStorageContainerType のみを登録できます。
  • 新しく作成されたテナントへのコンテナーの種類の登録は、テナントがまだ完全に準備されていない場合に失敗する可能性があります。 新しいテナントにコンテナーの種類を登録するには、少なくとも 1 時間待つ必要がある場合があります。

登録中に設定を変更することはできません。

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) FileStorageContainerTypeReg.Selected FileStorageContainerTypeReg.Manage.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション FileStorageContainerTypeReg.Selected 注意事項なし。

注:

  • 委任されたトークンを使用する場合は、SharePoint Embedded 管理者ロールまたはグローバル管理者ロールのいずれかが必要です。
  • 登録は、 fileStorageContainerType を所有するアプリケーションのコンテキストで行う必要があります。

HTTP 要求

現在のテナントに fileStorageContainerType を登録します。

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}

メモ： PUT メソッドを使用します。 この要求により、指定された ID ( fileStorageContainerTypeId ) を使用して fileStorageContainertypeRegistration オブジェクトが作成されます。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 fileStorageContainerTypeRegistration オブジェクトの JSON 表現を指定します。

fileStorageContainerTypeRegistration を作成するときに、次のプロパティを指定できます。

プロパティ 型 説明
applicationPermissionGrants fileStorageContainerTypeAppPermissionGrant コレクション 特定の fileStorageContainerType のコンテナーに対するアプリケーションのアクセス特権。 省略可能。

応答

成功した場合、このメソッドは応答コード 201 Created と、応答本文の fileStorageContainerTypeRegistration オブジェクトを返します。

例

例 1: 試用版 fileStorageContainerType の fileStorageContainerTypeRegistration を作成する

次の例は、applicationPermissionGrants を使用して試用版 fileStorageContainerType の fileStorageContainerTypeRegistration を作成する方法を示しています。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

例 2: 課金設定が完了しない標準の fileStorageContainerType の fileStorageContainerTypeRegistration を作成する

次の例は、課金設定が完了しない標準の fileStorageContainerType の fileStorageContainerTypeRegistration を作成する方法を示しています。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

HTTP/1.1 405 Method Not Allowed
  • Last updated on