10000 Fix urls (#39117) · Azure/azure-sdk-for-python@5cd5867 · GitHub
[go: up one dir, main page]
Skip to content

Commit 5cd5867

Browse files
xiangyan99xiangyan99
authored
Fix urls (#39117)
1 parent 895e0b8 commit 5cd5867

File tree

55 files changed

+449
-449
lines changed
  • _page_blob_operations.py
  • _service_operations.py
  • _models.py
  • _shared
  • samples
  • azure-storage-file-datalake
  • azure-storage-file-share
  • azure-storage-queue

    • Some content is hidden

    Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

    55 files changed

    +449
    -449
    lines changed

    ‎sdk/storage/azure-storage-blob-changefeed/README.md

    Lines changed: 8 additions & 8 deletions
    Original file line numberDiff line numberDiff line change
    @@ -3,15 +3,15 @@
    33
    This preview package for Python enables users to get blob change feed events. These events can be lazily generated, iterated by page, retrieved for a specific time interval, or iterated from a specific continuation token.
    44

    55

    6-
    [Source code](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob-changefeed/azure/storage/blob/changefeed) | [Package (PyPi)](https://pypi.org/project/azure-storage-blob-changefeed/) | [API reference documentation](https://aka.ms/azsdk-python-storage-blob-changefeed-ref) | [Product documentation](https://docs.microsoft.com/azure/storage/) | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob-changefeed/samples)
    6+
    [Source code](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob-changefeed/azure/storage/blob/changefeed) | [Package (PyPi)](https://pypi.org/project/azure-storage-blob-changefeed/) | [API reference documentation](https://aka.ms/azsdk-python-storage-blob-changefeed-ref) | [Product documentation](https://learn.microsoft.com/azure/storage/) | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob-changefeed/samples)
    77

    88

    99
    ## Getting started
    1010

    1111
    ### Prerequisites
    1212
    * Python 3.8 or later is required to use this package. For more details, please read our page on [Azure SDK for Python version support policy](https://github.com/Azure/azure-sdk-for-python/wiki/Azure-SDKs-Python-version-support-policy).
    1313
    * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an
    14-
    [Azure storage account](https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-quickstart-create-account) to use this package.
    14+
    [Azure storage account](https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-quickstart-create-account) to use this package.
    1515

    1616
    ### Install the package
    1717
    Install the Azure Storage Blob ChangeFeed client library for Python with [pip](https://pypi.org/project/pip/):
    @@ -22,9 +22,9 @@ pip install azure-storage-blob-changefeed --pre
    2222

    2323
    ### Create a storage account
    2424
    If you wish to create a new storage account, you can use the
    25-
    [Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal),
    26-
    [Azure PowerShell](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell),
    27-
    or [Azure CLI](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli):
    25+
    [Azure Portal](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal),
    26+
    [Azure PowerShell](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell),
    27+
    or [Azure CLI](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli):
    2828

    2929
    ```bash
    3030
    # Create a new resource group to hold the storage account -
    @@ -36,9 +36,9 @@ az storage account create -n my-storage-account-name -g my-resource-group
    3636
    ```
    3737

    3838
    To enable changefeed you can use:
    39-
    [Azure Portal](https://docs.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-portal#enable-and-disable-the-change-feed),
    40-
    [Azure PowerShell](https://docs.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-powershell#enable-and-disable-the-change-feed)
    41-
    or [Template](https://docs.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=template#enable-and-disable-the-change-feed).
    39+
    [Azure Portal](https://learn.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-portal#enable-and-disable-the-change-feed),
    40+
    [Azure PowerShell](https://learn.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=azure-powershell#enable-and-disable-the-change-feed)
    41+
    or [Template](https://learn.microsoft.com/azure/storage/blobs/storage-blob-change-feed?tabs=template#enable-and-disable-the-change-feed).
    4242

    4343
    ### Authenticate the client
    4444

    ‎sdk/storage/azure-storage-blob-changefeed/samples/README.md

    Lines changed: 1 addition & 1 deletion
    Original file line numberDiff line numberDiff line change
    @@ -24,7 +24,7 @@ Several Storage Blobs Python SDK samples are available to you in the SDK's GitHu
    2424
    ## Prerequisites
    2525
    * Python 3.6 or later is required to use this package
    2626
    * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an
    27-
    [Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to run these samples.
    27+
    [Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to run these samples.
    2828

    2929
    ## Setup
    3030

    ‎sdk/storage/azure-storage-blob/README.md

    Lines changed: 19 additions & 19 deletions
    Original file line numberDiff line numberDiff line change
    @@ -13,7 +13,7 @@ Blob storage is ideal for:
    1313
    | [Package (PyPI)](https://pypi.org/project/azure-storage-blob/)
    1414
    | [Package (Conda)](https://anaconda.org/microsoft/azure-storage/)
    1515
    | [API reference documentation](https://aka.ms/azsdk-python-storage-blob-ref)
    16-
    | [Product documentation](https://docs.microsoft.com/azure/storage/)
    16+
    | [Product documentation](https://learn.microsoft.com/azure/storage/)
    1717
    | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob/samples)
    1818

    1919

    @@ -22,7 +22,7 @@ Blob storage is ideal for:
    2222
    ### Prerequisites
    2323
    * Python 3.8 or later is required to use this package. For more details, please read our page on [Azure SDK for Python version support policy](https://github.com/Azure/azure-sdk-for-python/wiki/Azure-SDKs-Python-version-support-policy).
    2424
    * You must have an [Azure subscription](https://azure.microsoft.com/free/) and an
    25-
    [Azure storage account](https://docs.microsoft.com/azure/storage/common/storage-account-overview) to use this package.
    25+
    [Azure storage account](https://learn.microsoft.com/azure/storage/common/storage-account-overview) to use this package.
    2626

    2727
    ### Install the package
    2828
    Install the Azure Storage Blobs client library for Python with [pip](https://pypi.org/project/pip/):
    @@ -33,9 +33,9 @@ pip install azure-storage-blob
    3333

    3434
    ### Create a storage account
    3535
    If you wish to create a new storage account, you can use the
    36-
    [Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal),
    37-
    [Azure PowerShell](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell),
    38-
    or [Azure CLI](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli):
    36+
    [Azure Portal](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal),
    37+
    [Azure PowerShell](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-powershell),
    38+
    or [Azure CLI](https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-cli):
    3939

    4040
    ```bash
    4141
    # Create a new resource group to hold the storage account -
    @@ -60,9 +60,9 @@ service = BlobServiceClient(account_url="https://<my-storage-account-name>.blob.
    6060

    6161
    #### Looking up the account URL
    6262
    You can find the storage account's blob service URL using the
    63-
    [Azure Portal](https://docs.microsoft.com/azure/storage/common/storage-account-overview#storage-account-endpoints),
    64-
    [Azure PowerShell](https://docs.microsoft.com/powershell/module/az.storage/get-azstorageaccount),
    65-
    or [Azure CLI](https://docs.microsoft.com/cli/azure/storage/account?view=azure-cli-latest#az-storage-account-show):
    63+
    [Azure Portal](https://learn.microsoft.com/azure/storage/common/storage-account-overview#storage-account-endpoints),
    64+
    [Azure PowerShell](https://learn.microsoft.com/powershell/module/az.storage/get-azstorageaccount),
    65+
    or [Azure CLI](https://learn.microsoft.com/cli/azure/storage/account?view=azure-cli-latest#az-storage-account-show):
    6666

    6767
    ```bash
    6868
    # Get the blob service account url for the storage account
    @@ -71,17 +71,17 @@ az storage account show -n my-storage-account-name -g my-resource-group --query
    7171

    7272
    #### Types of credentials
    7373
    The `credential` parameter may be provided in a number of different forms, depending on the type of
    74-
    [authorization](https://docs.microsoft.com/azure/storage/common/storage-auth) you wish to use:
    75-
    1. To use an [Azure Active Directory (AAD) token credential](https://docs.microsoft.com/azure/storage/common/storage-auth-aad),
    74+
    [authorization](https://learn.microsoft.com/azure/storage/common/storage-auth) you wish to use:
    75+
    1. To use an [Azure Active Directory (AAD) token credential](https://learn.microsoft.com/azure/storage/common/storage-auth-aad),
    7676
    provide an instance of the desired credential type obtained from the
    7777
    [azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#credentials) library.
    7878
    For example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#defaultazurecredential)
    7979
    can be used to authenticate the client.
    8080

    8181
    This requires some initial setup:
    8282
    * [Install azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/identity/azure-identity#install-the-package)
    83-
    * [Register a new AAD application](https://docs.microsoft.com/azure/active-directory/develop/quickstart-register-app) and give permissions to access Azure Storage
    84-
    * [Grant access](https://docs.microsoft.com/azure/storage/common/storage-auth-aad-rbac-portal) to Azure Blob data with RBAC in the Azure Portal
    83+
    * [Register a new AAD application](https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app) and give permissions to access Azure Storage
    84+
    * [Grant access](https://learn.microsoft.com/azure/storage/common/storage-auth-aad-rbac-portal) to Azure Blob data with RBAC in the Azure Portal
    8585
    * Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
    8686
    AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET
    8787

    @@ -97,7 +97,7 @@ The `credential` parameter may be provided in a number of different forms, depen
    9797
    )
    9898
    ```
    9999

    100-
    2. To use a [shared access signature (SAS) token](https://docs.microsoft.com/azure/storage/common/storage-sas-overview),
    100+
    2. To use a [shared access signature (SAS) token](https://learn.microsoft.com/azure/storage/common/storage-sas-overview),
    101101
    provide the token as a string. If your account URL includes the SAS token, omit the credential parameter.
    102102
    You can generate a SAS token from the Azure Portal under "Shared access signature" or use one of the `generate_sas()`
    103103
    functions to create a sas token for the storage account, container, or blob:
    @@ -117,7 +117,7 @@ The `credential` parameter may be provided in a number of different forms, depen
    117117
    blob_service_client = BlobServiceClient(account_url="https://<my_account_name>.blob.core.windows.net", credential=sas_token)
    118118
    ```
    119119

    120-
    3. To use a storage account [shared key](https://docs.microsoft.com/rest/api/storageservices/authenticate-with-shared-key/)
    120+
    3. To use a storage account [shared key](https://learn.microsoft.com/rest/api/storageservices/authenticate-with-shared-key/)
    121121
    (aka account key or access key), provide the key as a string. This can be found in the Azure Portal under the "Access Keys"
    122122
    section or by running the following Azure CLI command:
    123123

    @@ -137,7 +137,7 @@ The `credential` parameter may be provided in a number of different forms, depen
    137137
    credential={"account_name": "<your_account_name>", "account_key":"<account_access_key>"})
    138138
    ```
    139139

    140-
    4. To use [anonymous public read access](https://docs.microsoft.com/azure/storage/blobs/storage-manage-access-to-resources),
    140+
    4. To use [anonymous public read access](https://learn.microsoft.com/azure/storage/blobs/storage-manage-access-to-resources),
    141141
    simply omit the credential parameter.
    142142

    143143
    #### Creating the client from a connection string
    @@ -198,13 +198,13 @@ objects are async context managers and define async `close` methods.
    198198

    199199
    ### Blob Types
    200200
    Once you've initialized a Client, you can choose from the different types of blobs:
    201-
    * [Block blobs](https://docs.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-block-blobs)
    201+
    * [Block blobs](https://learn.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-block-blobs)
    202202
    store text and binary data, up to approximately 4.75 TiB. Block blobs are made up of blocks of data that can be
    203203
    managed individually
    204-
    * [Append blobs](https://docs.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-append-blobs)
    204+
    * [Append blobs](https://learn.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-append-blobs)
    205205
    are made up of blocks like block blobs, but are optimized for append operations. Append blobs are ideal for scenarios
    206206
    such as logging data from virtual machines
    207-
    * [Page blobs](https://docs.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-page-blobs)
    207+
    * [Page blobs](https://learn.microsoft.com/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs#about-page-blobs)
    208208
    store random access files up to 8 TiB in size. Page blobs store virtual hard drive (VHD) files and serve as disks for
    209209
    Azure virtual machines
    210210

    @@ -461,7 +461,7 @@ Several Storage Blobs Python SDK samples are available to you in the SDK's GitHu
    461461
    * Delete a single file or recursively delete a directory
    462462

    463463
    ### Additional documentation
    464-
    For more extensive documentation on Azure Blob storage, see the [Azure Blob storage documentation](https://docs.microsoft.com/azure/storage/blobs/) on docs.microsoft.com.
    464+
    For more extensive documentation on Azure Blob storage, see the [Azure Blob storage documentation](https://learn.microsoft.com/azure/storage/blobs/) on learn.microsoft.com.
    465465

    466466
    ## Contributing
    467467
    This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

    ‎sdk/storage/azure-storage-blob/azure/storage/blob/_generated/aio/operations/_append_blob_operations.py

    Lines changed: 4 additions & 4 deletions
    Original file line numberDiff line numberDiff line change
    @@ -83,7 +83,7 @@ async def create( # pylint: disable=inconsistent-return-statements
    8383
    :type content_length: int
    8484
    :param timeout: The timeout parameter is expressed in seconds. For more information, see
    8585
    :code:`<a
    86-
    href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    86+
    href="https://learn.microsoft.com/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    8787
    Timeouts for Blob Service Operations.</a>`. Default value is None.
    8888
    :type timeout: int
    8989
    :param metadata: Optional. Specifies a user-defined name-value pair associated with the blob.
    @@ -273,7 +273,7 @@ async def append_block( # pylint: disable=inconsistent-return-statements
    273273
    :type body: IO[bytes]
    274274
    :param timeout: The timeout parameter is expressed in seconds. For more information, see
    275275
    :code:`<a
    276-
    href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    276+
    href="https://learn.microsoft.com/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    277277
    Timeouts for Blob Service Operations.</a>`. Default value is None.
    278278
    :type timeout: int
    279279
    :param transactional_content_md5: Specify the transactional md5 for the body, to be validated
    @@ -471,7 +471,7 @@ async def append_block_from_url( # pylint: disable=inconsistent-return-statemen
    471471
    :type source_contentcrc64: bytes
    472472
    :param timeout: The timeout parameter is expressed in seconds. For more information, see
    473473
    :code:`<a
    474-
    href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    474+
    href="https://learn.microsoft.com/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    475475
    Timeouts for Blob Service Operations.</a>`. Default value is None.
    476476
    :type timeout: int
    477477
    :param transactional_content_md5: Specify the transactional md5 for the body, to be validated
    @@ -646,7 +646,7 @@ async def seal( # pylint: disable=inconsistent-return-statements
    646646
    647647
    :param timeout: The timeout parameter is expressed in seconds. For more information, see
    648648
    :code:`<a
    649-
    href="https://docs.microsoft.com/en-us/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    649+
    href="https://learn.microsoft.com/rest/api/storageservices/fileservices/setting-timeouts-for-blob-service-operations">Setting
    650650
    Timeouts for Blob Service Operations.</a>`. Default value is None.
    651651
    :type timeout: int
    652652
    :param request_id_parameter: Provides a client-generated, opaque value with a 1 KB character

    0 commit comments

    Comments
     (0)
    0