Aracılığıyla paylaş

Sent Shares - Create Or Replace

Hizmet:
Purview
API Sürümü:
2023-02-15-preview

Gönderilmiş paylaşımı oluşturma veya değiştirme

PUT {endpoint}/sentShares/{sentShareId}?api-version=2023-02-15-preview

URI Parametreleri

Name İçinde Gerekli Tür Description
endpoint
 path True

string

Purview hesabınızın paylaşım uç noktası. Örnek: https://{accountName}.purview.azure.com/share
sentShareId
 path True

string

maxLength: 36
pattern: ^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$

Gönderilen paylaşımın kimliği
api-version
 query True

string

Kullanılacak api sürümü

İstek Gövdesi

InPlaceSentShare

InPlace paylaşım türü.

Name Gerekli Tür Description
properties True

InPlaceSentShareProperties

InPlace gönderilen paylaşımının özellikleri.
shareKind True string:

InPlace

Paylaşım için desteklenen türleri tanımlar.

Yanıtlar

Name Tür Description
200 OK SentShare:

InPlaceSentShare

Başarı

Üst Bilgiler

Operation-Location: string
201 Created SentShare:

InPlaceSentShare

Başarı

Üst Bilgiler

Operation-Location: string
Other Status Codes

PurviewShareError

Varsayılan hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

azureAuth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
https://purview.azure.net/.default Purview hizmet kapsamı

Örnekler

SentShares_CreateOrReplace
SentShares_CreateOrReplaceAdlsGen2Account
SentShares_CreateOrReplaceBlobAccount

SentShares_CreateOrReplace

Örnek isteği

PUT accountName.purview.azure.com/share/sentShares/FF4A2AAE-8755-47BB-9C00-A774B5A7006E?api-version=2023-02-15-preview

{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "SharedFile.txt"
          }
        ]
      }
    },
    "displayName": "sentShare1",
    "description": "description"
  },
  "shareKind": "InPlace"
}

Örnek yanıt

Durum kodu:
201 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}
Durum kodu:
200 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}

SentShares_CreateOrReplaceAdlsGen2Account

Örnek isteği

PUT accountName.purview.azure.com/share/sentShares/FF4A2AAE-8755-47BB-9C00-A774B5A7006E?api-version=2023-02-15-preview

{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "SharedFile.txt"
          }
        ]
      }
    },
    "displayName": "sentShare1",
    "description": "description"
  },
  "shareKind": "InPlace"
}

Örnek yanıt

Durum kodu:
201 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}
Durum kodu:
200 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "AdlsGen2Account",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}

SentShares_CreateOrReplaceBlobAccount

Örnek isteği

PUT accountName.purview.azure.com/share/sentShares/FF4A2AAE-8755-47BB-9C00-A774B5A7006E?api-version=2023-02-15-preview

{
  "properties": {
    "artifact": {
      "storeKind": "BlobAccount",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "SharedFile.txt"
          }
        ]
      }
    },
    "displayName": "sentShare1",
    "description": "description"
  },
  "shareKind": "InPlace"
}

Örnek yanıt

Durum kodu:
201 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "BlobAccount",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}
Durum kodu:
200 
Date: Wed, 13 Sep 2017 18:04:32 GMT
x-ms-correlation-request-id: 25c78f97-0b0a-4fe9-ad39-883a482265cd
x-ms-long-running-operation: True
Operation-Location: https://accountName.purview.azure.com/share/operationResults/dad6baec-3a39-41df-a469-843a9ee94213?api-version=2023-02-15-preview
Operation-Id: dad6baec-3a39-41df-a469-843a9ee94213
{
  "properties": {
    "artifact": {
      "storeKind": "BlobAccount",
      "storeReference": {
        "referenceName": "/subscriptions/de06c3a0-4610-4ca0-8cbb-bbdac204bd65/resourceGroups/sender-storage-rg/providers/Microsoft.Storage/storageAccounts/providerstorage",
        "type": "ArmResourceReference"
      },
      "properties": {
        "paths": [
          {
            "containerName": "container1",
            "senderPath": "directory/file.txt",
            "receiverPath": "ShareFile.txt"
          }
        ]
      }
    },
    "createdAt": "2021-07-21T23:45:35.3708674Z",
    "displayName": "sentShare1",
    "description": "description",
    "dependsOn": [],
    "state": "Succeeded",
    "senderName": "John Smith",
    "senderEmail": "johnsmith@contoso.com",
    "senderTenantName": "Contoso"
  },
  "id": "FF4A2AAE-8755-47BB-9C00-A774B5A7006E",
  "type": "SentShare",
  "shareKind": "InPlace"
}

Tanımlar

Name Description
AdlsGen2Artifact

Adls 2. Nesil depolama hesabı yapıtı.
AdlsGen2ArtifactProperties

Adls 2. Nesil depolama hesabının özellikleri.
BlobStorageArtifact

Blob depolama hesabı yapıtı.
BlobStorageArtifactProperties

Blob depolama hesabının özellikleri.
InPlaceSentShare

InPlace paylaşım türü.
InPlaceSentShareProperties

InPlace gönderilen paylaşımının özellikleri.
PurviewShareError

purview paylaşımı hata modeli.
PurviewShareErrorInfo

purview paylaşımı hata gövdesi modeli.
ReferenceNameType

Paylaşılmakta olan kaynağın türünü tanımlar
ShareKind

Paylaşım için desteklenen türleri tanımlar.
State

Kaynağın durumu
StorageAccountPath

Tek bir StorageAccountPath yolu tanımlar
StoreKind

Varlık türleri.
StoreReference

Yapıt veya havuz için Mağaza Başvurusu.

AdlsGen2Artifact

Object

Adls 2. Nesil depolama hesabı yapıtı.

Name Tür Description
properties

AdlsGen2ArtifactProperties

Adls 2. Nesil depolama hesabının özellikleri.
storeKind string:

AdlsGen2Account

Varlık türleri.
storeReference

StoreReference

Yapıt veya havuz için Mağaza Başvurusu.

AdlsGen2ArtifactProperties

Object

Adls 2. Nesil depolama hesabının özellikleri.

Name Tür Description
location

string

Depolama hesabının konumu.
paths

StorageAccountPath[]

Adls 2. Nesil depolama hesabı yollarının listesi.

BlobStorageArtifact

Object

Blob depolama hesabı yapıtı.

Name Tür Description
properties

BlobStorageArtifactProperties

Blob depolama hesabının özellikleri.
storeKind string:

BlobAccount

Varlık türleri.
storeReference

StoreReference

Yapıt veya havuz için Mağaza Başvurusu.

BlobStorageArtifactProperties

Object

Blob depolama hesabının özellikleri.

Name Tür Description
location

string

Depolama hesabının konumu.
paths

StorageAccountPath[]

Blob depolama hesabı yollarının listesi.

InPlaceSentShare

Object

InPlace paylaşım türü.

Name Tür Description
id

string

Kaynağın benzersiz kimliği.
properties

InPlaceSentShareProperties

InPlace gönderilen paylaşımının özellikleri.
shareKind string:

InPlace

Paylaşım için desteklenen türleri tanımlar.
type

string

Kaynağın türü.

InPlaceSentShareProperties

Object

InPlace gönderilen paylaşımının özellikleri.

Name Tür Description
artifact Artifact:

Gönderilmiş paylaşım yapıtı için bir sınıf.
createdAt

string (date-time)

Gönderilen paylaşımın oluşturulduğu saat. RFC 3339 tarafından tanımlanan standart tarih-saat biçiminde temsil edilir
dependsOn

string[] (uuid)

Gönderilen paylaşımın bağlı olduğu paylaşımların listesi.
description

string

Gönderilen paylaşım açıklaması.
displayName

string

Gönderilen paylaşımın adı
senderEmail

string

Gönderilen paylaşımı oluşturan gönderenin e-postası.
senderName

string

Gönderilen paylaşımı oluşturan gönderenin adı.
senderTenantName

string

Gönderilen paylaşımı oluşturan gönderenin kiracı adı.
state

State

Kaynağın durumu

PurviewShareError

Object

purview paylaşımı hata modeli.

Name Tür Description
error

PurviewShareErrorInfo

purview paylaşımı hata gövdesi modeli.

PurviewShareErrorInfo

Object

purview paylaşımı hata gövdesi modeli.

Name Tür Description
code

string

Hatanın kodu
details

PurviewShareErrorInfo[]

Hata modelinin iç içe ayrıntıları
message

string

Hata iletisi
target

string

Hatanın hedefi

ReferenceNameType

Listeleme

Paylaşılmakta olan kaynağın türünü tanımlar

Değer Description
ArmResourceReference

Başvuru türü bir ARM kaynağıdır

ShareKind

Listeleme

Paylaşım için desteklenen türleri tanımlar.

Değer Description
InPlace

Paylaşım türü yerinde paylaşımdır

State

Listeleme

Kaynağın durumu

Değer Description
Unknown

Kaynağın durumu 'Bilinmiyor'
Succeeded

Kaynağın durumu 'Başarılı'
Creating

Kaynağın durumu 'Oluşturuluyor'
Deleting

Kaynağın durumu 'Siliniyor'
Moving

Kaynağın durumu 'Taşınıyor'
Failed

Kaynağın durumu 'Başarısız'

StorageAccountPath

Object

Tek bir StorageAccountPath yolu tanımlar

Name Tür Description
containerName

string

Kapsayıcı adını alır veya ayarlar
receiverPath

string

Yapıtın eşlenecek olduğu alıcı tarafında yolu alır veya ayarlar
senderPath

string

Paylaşılacak kapsayıcı içinde dosya/klasör yolunu alır veya ayarlar

StoreKind

Listeleme

Varlık türleri.

Değer Description
AdlsGen2Account

Mağaza türü bir Adls 2. Nesil depolama hesabıdır
BlobAccount

Mağaza türü bir Blob depolama hesabıdır

StoreReference

Object

Yapıt veya havuz için Mağaza Başvurusu.

Name Tür Description
referenceName

string

Havuz veya yapıtla ilişkili kaynağın başvuru adı.
type

ReferenceNameType

Paylaşılmakta olan kaynağın türünü tanımlar