Skip to content

Commit 2e56320

Browse files
Merge pull request #308524 from DespindolaMS/docs-editor/security-restrict-copy-operati-1763581462
Update security-restrict-copy-operations.md
2 parents 88635ff + b258b22 commit 2e56320

1 file changed

Lines changed: 19 additions & 2 deletions

File tree

articles/storage/common/security-restrict-copy-operations.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.custom:
1818

1919
# Restrict the source of copy operations to a storage account
2020

21-
For security reasons, storage administrators might want to limit the environments from which data can be copied to secured accounts. Limiting the scope of permitted copy operations helps prevent the infiltration of unwanted data from untrusted tenants or virtual networks.
21+
For security reasons, storage administrators might want to limit the environments from which data can be copied to storage accounts. Limiting the scope of permitted copy operations helps prevent the infiltration of unwanted data from untrusted tenants or virtual networks.
2222

2323
This article shows you how to limit the source accounts of copy operations to accounts within the same tenant as the destination account, or with private links to the same virtual network as the destination.
2424

@@ -34,7 +34,24 @@ The **AllowedCopyScope** property of a storage account is used to specify the en
3434
- **Microsoft Entra ID**: Permits copying only from accounts within the same Microsoft Entra tenant as the destination account.
3535
- **PrivateLink**: Permits copying only from storage accounts that have private links to the same virtual network as the destination account.
3636

37-
The setting applies to [Copy Blob](/rest/api/storageservices/copy-blob) and [Copy Blob From URL](/rest/api/storageservices/copy-blob-from-url) operations.
37+
The following table details operations that require the `x-ms-copy-source` request header that this setting applies to:
38+
39+
| REST API | Permitted scope applies |
40+
| --- | --- |
41+
| [Put Block From Url](/rest/api/storageservices/put-block-from-url?tabs=microsoft-entra-id) | Yes |
42+
| [Append Block From Url](/rest/api/storageservices/append-block-from-url?tabs=microsoft-entra-id) | Yes |
43+
| [Put Blob From Url](/rest/api/storageservices/put-blob-from-url?tabs=microsoft-entra-id) | Yes |
44+
| [Put Page From Url](/rest/api/storageservices/put-page-from-url?tabs=microsoft-entra-id) | Yes |
45+
| [Copy Blob](/rest/api/storageservices/copy-blob) | Yes |
46+
| [Copy Blob From URL](/rest/api/storageservices/copy-blob-from-url) | Yes |
47+
| [Incremental Copy Blob](/rest/api/storageservices/incremental-copy-blob) | Yes |
48+
| [Put Range From Url](/rest/api/storageservices/put-range-from-url) | Yes |
49+
| [Copy File](/rest/api/storageservices/copy-file) | Yes |
50+
51+
> [!NOTE]
52+
> Storage clients such as [AzCopy](/azure/storage/common/storage-use-azcopy-v10) that rely on these APIs will be impacted by this setting. Please review the APIs associated with other features and services to ensure compatibility.
53+
54+
The error “The copy operation is not within the allowed copy scope” indicates that the attempted copy operation falls outside the permitted scope for your account. Should you encounter the error “This request is not authorized to perform this operation” please verify whether permitted scope or a related firewall rule is denying the request.
3855

3956
When the source of a copy request does not meet the requirements specified by this setting, the request fails with HTTP status code 403 (Forbidden).
4057

0 commit comments

Comments
 (0)