Docs links coversion: docs.microsoft.com -> learn.microsoft.com (#6276)
* Docs links coversion: docs.microsoft.com -> learn.microsoft.com Some markdown formatting * Adding "msrc" to cspell words * Undoing things auto formatter did * Appling Ahson's suggestions
This commit is contained in:
parent
a046842add
commit
b391d65809
1
.vscode/cspell.json
vendored
1
.vscode/cspell.json
vendored
@ -180,6 +180,7 @@
|
||||
"msedge",
|
||||
"msft",
|
||||
"msiexec",
|
||||
"msrc",
|
||||
"MSRC",
|
||||
"Mykhailo",
|
||||
"nbio",
|
||||
|
||||
@ -48,7 +48,7 @@ endif()
|
||||
|
||||
if(MSVC_USE_STATIC_CRT AND MSVC)
|
||||
# 1. More about static/shared CRT:
|
||||
# https://docs.microsoft.com/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-160
|
||||
# https://learn.microsoft.com/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-160
|
||||
#
|
||||
# 2. MSVC_USE_STATIC_CRT build flag approach is used/inspired by libcurl
|
||||
# (https://github.com/curl/curl/blob/master/CMakeLists.txt) and some other projects.
|
||||
|
||||
@ -115,7 +115,7 @@ cmake --build .
|
||||
|
||||
#### Static Analysis
|
||||
|
||||
When the project is built using MSVC on Windows, the compiler can run [static analysis](https://docs.microsoft.com/cpp/code-quality/walkthrough-analyzing-c-cpp-code-for-defects) on the code. The CMake project can add the required compiler flags to perform this check. To enable this feature, set an environment variable `AZURE_ENABLE_STATIC_ANALYSIS`.
|
||||
When the project is built using MSVC on Windows, the compiler can run [static analysis](https://learn.microsoft.com/cpp/code-quality/walkthrough-analyzing-c-cpp-code-for-defects) on the code. The CMake project can add the required compiler flags to perform this check. To enable this feature, set an environment variable `AZURE_ENABLE_STATIC_ANALYSIS`.
|
||||
|
||||
Keep in mind that enabling static analysis will significantly impact build time. It is recommended to run it right before submitting the PR, but not in your inner developer loop.
|
||||
|
||||
|
||||
@ -306,7 +306,7 @@ The following SDK library releases are available on [vcpkg](https://github.com/m
|
||||
- `azure-storage-files-shares-cpp`
|
||||
- `azure-storage-queues-cpp`
|
||||
|
||||
> NOTE: In case of getting linker errors when consuming the SDK on Windows, make sure that [vcpkg triplet](https://github.com/microsoft/vcpkg-docs/blob/main/vcpkg/users/triplets.md) being consumed matches the [CRT link flags](https://docs.microsoft.com/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-160) being set for your app or library build. See also `MSVC_USE_STATIC_CRT` build flag.
|
||||
> NOTE: In case of getting linker errors when consuming the SDK on Windows, make sure that [vcpkg triplet](https://github.com/microsoft/vcpkg-docs/blob/main/vcpkg/users/triplets.md) being consumed matches the [CRT link flags](https://learn.microsoft.com/cpp/build/reference/md-mt-ld-use-run-time-library?view=msvc-160) being set for your app or library build. See also `MSVC_USE_STATIC_CRT` build flag.
|
||||
|
||||
## OpenSSL Version
|
||||
|
||||
@ -355,7 +355,7 @@ which allows you to use the system package manager to install dependencies.
|
||||
## Need help
|
||||
|
||||
- For reference documentation visit the [Azure SDK for C++ documentation](https://azure.github.io/azure-sdk-for-cpp).
|
||||
- For tutorials, samples, quick starts and other documentation, visit [Azure for C++ Developers](https://docs.microsoft.com/azure/).
|
||||
- For tutorials, samples, quick starts and other documentation, visit [Azure for C++ Developers](https://learn.microsoft.com/azure/).
|
||||
- File an issue via [GitHub Issues](https://github.com/Azure/azure-sdk-for-cpp/issues/new/choose).
|
||||
|
||||
## Navigating the repository
|
||||
|
||||
18
SECURITY.md
18
SECURITY.md
@ -1,10 +1,10 @@
|
||||
<!-- BEGIN MICROSOFT SECURITY.MD V0.0.3 BLOCK -->
|
||||
|
||||
## Security
|
||||
# Security
|
||||
|
||||
Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
|
||||
|
||||
If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below.
|
||||
If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://learn.microsoft.com/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below.
|
||||
|
||||
## Reporting Security Issues
|
||||
|
||||
@ -18,13 +18,13 @@ You should receive a response within 24 hours. If for some reason you do not, pl
|
||||
|
||||
Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
|
||||
|
||||
* Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
|
||||
* Full paths of source file(s) related to the manifestation of the issue
|
||||
* The location of the affected source code (tag/branch/commit or direct URL)
|
||||
* Any special configuration required to reproduce the issue
|
||||
* Step-by-step instructions to reproduce the issue
|
||||
* Proof-of-concept or exploit code (if possible)
|
||||
* Impact of the issue, including how an attacker might exploit the issue
|
||||
* Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
|
||||
* Full paths of source file(s) related to the manifestation of the issue
|
||||
* The location of the affected source code (tag/branch/commit or direct URL)
|
||||
* Any special configuration required to reproduce the issue
|
||||
* Step-by-step instructions to reproduce the issue
|
||||
* Proof-of-concept or exploit code (if possible)
|
||||
* Impact of the issue, including how an attacker might exploit the issue
|
||||
|
||||
This information will help us triage your report more quickly.
|
||||
|
||||
|
||||
@ -3,26 +3,29 @@
|
||||
## How to file issues and get help
|
||||
|
||||
Customers with an [Azure support plan](https://azure.microsoft.com/support/options/) can open an [Azure support ticket](https://azure.microsoft.com/support/create-ticket/).
|
||||
**We recommend this option if your problem requires immediate attention.**
|
||||
**We recommend this option if your problem requires immediate attention.**
|
||||
|
||||
### Github issues
|
||||
|
||||
We use [GitHub Issues](https://github.com/Azure/azure-sdk-for-python/issues/new/choose) to track bugs, questions, and feature requests.
|
||||
GitHub issues are free, but **response time is not guaranteed.** See [GitHub issues support process](https://devblogs.microsoft.com/azure-sdk/github-issue-support-process/) for more details.
|
||||
|
||||
To ensure the relevance and manageability of our issue queue, we have an automated process that will close issues that are over two years old and have not been updated in the last 30 days. This measure is designed to help us respond to and resolve current issues more efficiently. We appreciate your understanding and cooperation in maintaining a focused and up-to-date issue tracking system.
|
||||
|
||||
### Community resources
|
||||
|
||||
- Search for similar issues in [our GitHub repository](https://github.com/Azure/azure-sdk-for-python/issues)
|
||||
- Ask a question on [StackOverflow](https://stackoverflow.com/questions/tagged/azure-sdk-python) and tag it with azure-sdk-python
|
||||
- Share or upvote feature requests on [Feedback Page](https://feedback.azure.com/forums/34192--general-feedback).
|
||||
- Take a look at the [Azure SDK blog](https://devblogs.microsoft.com/azure-sdk/).
|
||||
- Chat with other community members on [gitter](https://gitter.im/Azure/azure-sdk-for-python?source=orgpage)
|
||||
- Ask a question on [Twitter](https://twitter.com/AzureSDK)
|
||||
- Ask a question at [Microsoft Q&A](https://docs.microsoft.com/answers/products/azure?WT.mc_id=Portal-Microsoft_Azure_Support&product=all)
|
||||
- Ask a question at [Microsoft Q&A](https://learn.microsoft.com/answers/products/azure?WT.mc_id=Portal-Microsoft_Azure_Support&product=all)
|
||||
- Ask a question at [Microsoft Tech Community](https://techcommunity.microsoft.com/t5/azure/ct-p/Azure)
|
||||
|
||||
### Security bugs
|
||||
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center(secure@microsoft.com).
|
||||
|
||||
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center(secure@microsoft.com).
|
||||
You should receive a response within 24 hours.
|
||||
Further information, including the MSRC PGP key, can be found in the [Security TechCenter](https://www.microsoft.com/msrc/faqs-report-an-issue?rtc=1)
|
||||
|
||||
|
||||
@ -32,7 +32,7 @@ Simple applications that illustrate the different approaches to integrate the Az
|
||||
## Sample Applications
|
||||
|
||||
Sometimes we want to illustrate how several APIs or even packages work together in a context of a more complete program. For these cases, we created sample applications that you can look at, download, compile, and execute. These application samples are located on
|
||||
[https://docs.microsoft.com/samples/](https://docs.microsoft.com/samples/).
|
||||
[https://learn.microsoft.com/samples/](https://learn.microsoft.com/samples/).
|
||||
|
||||
## How-To Guide List
|
||||
|
||||
|
||||
@ -528,5 +528,5 @@ CMakeUserPresets.json
|
||||
|
||||
- Now you can push your project up to git, and collaboraters can clone it to work on the project with you. They will need to make sure they have properly set up their C++ compiler, CMake, adn vcpkg. They will also need to create their own `CMakeUsersPresets.json` file to point to where they installed the `vcpkg.cmake` module.
|
||||
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
|
||||
@ -62,5 +62,5 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_DATA_APPCONFIGURATION_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_DATA_APPCONFIGURATION_DLL) \
|
||||
|
||||
@ -12,7 +12,7 @@ Azure Attestation receives evidence from compute entities, turns them into a set
|
||||
|
||||
## Getting started
|
||||
|
||||
For the best development experience, we recommend that developers use the [CMake projects in Visual Studio](https://docs.microsoft.com/cpp/build/cmake-projects-in-visual-studio?view=vs-2019) to view and build the source code together with its dependencies.
|
||||
For the best development experience, we recommend that developers use the [CMake projects in Visual Studio](https://learn.microsoft.com/cpp/build/cmake-projects-in-visual-studio?view=vs-2019) to view and build the source code together with its dependencies.
|
||||
|
||||
### Prerequisites
|
||||
|
||||
@ -182,7 +182,7 @@ the certificate issued by the server can be verified using the [oe_verify_attest
|
||||
|
||||
Each attestation service instance has a policy applied to it which defines additional criteria which the customer has defined.
|
||||
|
||||
For more information on attestation policies, see [Attestation Policy](https://docs.microsoft.com/azure/attestation/author-sign-policy)
|
||||
For more information on attestation policies, see [Attestation Policy](https://learn.microsoft.com/azure/attestation/author-sign-policy)
|
||||
|
||||
### Isolated Mode certificate management
|
||||
|
||||
@ -429,11 +429,11 @@ std::cout << "The result of the certificate remove operation is: "
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
Troubleshooting information for the MAA service can be found [here](https://docs.microsoft.com/azure/attestation/troubleshoot-guide)
|
||||
Troubleshooting information for the MAA service can be found [here](https://learn.microsoft.com/azure/attestation/troubleshoot-guide)
|
||||
|
||||
## Next steps
|
||||
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://docs.microsoft.com/azure/attestation/).
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://learn.microsoft.com/azure/attestation/).
|
||||
|
||||
## Contributing
|
||||
|
||||
@ -468,25 +468,25 @@ Security issues and bugs should be reported privately, via email, to the Microso
|
||||
|
||||
Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk-for-cpp/blob/main/LICENSE.txt) license.
|
||||
<!-- LINKS -->
|
||||
[style-guide-msft]: https://docs.microsoft.com/style-guide/capitalization
|
||||
[azure_attestation]: https://docs.microsoft.com/azure/attestation
|
||||
[style-guide-msft]: https://learn.microsoft.com/style-guide/capitalization
|
||||
[azure_attestation]: https://learn.microsoft.com/azure/attestation
|
||||
[azure_identity]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/identity/azure-identity
|
||||
[azure_subscription]: https://azure.microsoft.com/
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[rest_api]: https://docs.microsoft.com/rest/api/attestation/
|
||||
[azure_create_application_in_portal]: https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[rest_api]: https://learn.microsoft.com/rest/api/attestation/
|
||||
[azure_create_application_in_portal]: https://learn.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
|
||||
[azure_cloud_shell]: https://shell.azure.com/bash
|
||||
[microsoft_code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||

|
||||
|
||||
@ -233,7 +233,7 @@ namespace Azure { namespace Security { namespace Attestation {
|
||||
/**
|
||||
* @brief Sends TPM-based attestation data to the service.
|
||||
* The TPM attestation protocol is defined
|
||||
* [here](https://docs.microsoft.com/azure/attestation/virtualization-based-security-protocol')
|
||||
* [here](https://learn.microsoft.com/azure/attestation/virtualization-based-security-protocol)
|
||||
*
|
||||
*
|
||||
* @param dataToAttest - Attestation request data.
|
||||
|
||||
@ -458,7 +458,7 @@ namespace Azure { namespace Security { namespace Attestation { namespace Models
|
||||
/** @brief Attestation response data.
|
||||
*
|
||||
* The TPM attestation protocol is defined
|
||||
* [here](https://docs.microsoft.com/azure/attestation/virtualization-based-security-protocol')
|
||||
* [here](https://learn.microsoft.com/azure/attestation/virtualization-based-security-protocol')
|
||||
*
|
||||
*/
|
||||
std::vector<uint8_t> TpmResult;
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_ATTESTATION_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_ATTESTATION_DLL) || (0 /*@AZ_ATTESTATION_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -147,11 +147,11 @@ the SGX enclave is configured as follows:
|
||||
Assuming a token is issued, this policy will cause a claim named `<custom-name>`
|
||||
to be issued with a value which matches the `x-ms-sgx-mrsigner` claim.
|
||||
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://docs.microsoft.com/azure/attestation/author-sign-policy)
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://learn.microsoft.com/azure/attestation/author-sign-policy)
|
||||
|
||||
## Next Steps
|
||||
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://docs.microsoft.com/azure/attestation/) .
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://learn.microsoft.com/azure/attestation/) .
|
||||
|
||||
## Contributing
|
||||
|
||||
|
||||
@ -75,11 +75,11 @@ the SGX enclave is configured as follows:
|
||||
Assuming a token is issued, this policy will cause a claim named `<custom-name>`
|
||||
to be issued with a value which matches the `x-ms-sgx-mrsigner` claim.
|
||||
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://docs.microsoft.com/azure/attestation/author-sign-policy)
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://learn.microsoft.com/azure/attestation/author-sign-policy)
|
||||
|
||||
## Next Steps
|
||||
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://docs.microsoft.com/azure/attestation/) .
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://learn.microsoft.com/azure/attestation/) .
|
||||
|
||||
<!-- LINKS -->
|
||||
<!-- links are known to be broken, they will be fixed after this initial pull
|
||||
|
||||
@ -39,7 +39,7 @@ Add_Policy_Certificates| Adds and removes a policy management certificates for t
|
||||
|
||||
## Next Steps
|
||||
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://docs.microsoft.com/azure/attestation/) .
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://learn.microsoft.com/azure/attestation/) .
|
||||
|
||||
<!-- LINKS -->
|
||||
<!-- links are known to be broken, they will be fixed after this initial pull
|
||||
|
||||
@ -75,11 +75,11 @@ the SGX enclave is configured as follows:
|
||||
Assuming a token is issued, this policy will cause a claim named `<custom-name>`
|
||||
to be issued with a value which matches the `x-ms-sgx-mrsigner` claim.
|
||||
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://docs.microsoft.com/azure/attestation/author-sign-policy)
|
||||
For more information on authoring attestation policy documents, see: [Authoring an attestation policy](https://learn.microsoft.com/azure/attestation/author-sign-policy)
|
||||
|
||||
## Next Steps
|
||||
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://docs.microsoft.com/azure/attestation/) .
|
||||
For more information about the Microsoft Azure Attestation service, please see our [documentation page](https://learn.microsoft.com/azure/attestation/) .
|
||||
|
||||
<!-- LINKS -->
|
||||
<!-- links are known to be broken, they will be fixed after this initial pull
|
||||
|
||||
@ -96,13 +96,13 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_sdk_cpp_development_guidelines]: https://azure.github.io/azure-sdk/cpp_introduction.html
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||

|
||||
|
||||
@ -12,7 +12,7 @@
|
||||
/**
|
||||
* @def AZ_CORE_AMQP_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_CORE_AMQP_DLL) || (0 /*@AZ_CORE_AMQP_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -4,7 +4,7 @@
|
||||
|
||||
Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
|
||||
|
||||
If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below.
|
||||
If you believe you have found a security vulnerability in any Microsoft-owned repository that meets Microsoft's [Microsoft's definition of a security vulnerability](https://learn.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)) of a security vulnerability, please report it to us as described below.
|
||||
|
||||
## Reporting Security Issues
|
||||
|
||||
|
||||
@ -43,12 +43,12 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_sdk_cpp_development_guidelines]: https://azure.github.io/azure-sdk/cpp_introduction.html
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||
@ -128,13 +128,13 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_sdk_cpp_development_guidelines]: https://azure.github.io/azure-sdk/cpp_introduction.html
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||

|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_CORE_TRACING_OPENTELEMETRY_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_CORE_TRACING_OPENTELEMETRY_DLL) \
|
||||
|
||||
@ -165,11 +165,11 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_sdk_cpp_development_guidelines]: https://azure.github.io/azure-sdk/cpp_introduction.html
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||
@ -70,7 +70,7 @@
|
||||
/**
|
||||
* @def AZ_CORE_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_CORE_DLL) || (0 /*@AZ_CORE_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -193,7 +193,7 @@ namespace Azure { namespace Core { namespace Tracing { namespace _internal {
|
||||
*
|
||||
* @param options Client Options for tracing.
|
||||
* @param serviceName Name of the resource provider for the service [See
|
||||
* also](https://docs.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers).
|
||||
* also](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers).
|
||||
* @param packageName Name of the package containing this service client.
|
||||
* @param packageVersion Optional package version number for the package containing this
|
||||
* service. (https://opentelemetry.io/docs/reference/specification/trace/api/#get-a-tracer).
|
||||
@ -220,7 +220,7 @@ namespace Azure { namespace Core { namespace Tracing { namespace _internal {
|
||||
*
|
||||
* @param options Client Options for tracing.
|
||||
* @param serviceName Name of the resource provider for the service [See
|
||||
* also](https://docs.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers).
|
||||
* also](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers).
|
||||
* @param packageVersion Package version number for the package containing this
|
||||
* service. (https://opentelemetry.io/docs/reference/specification/trace/api/#get-a-tracer).
|
||||
*
|
||||
@ -310,7 +310,7 @@ namespace Azure { namespace Core { namespace Tracing { namespace _internal {
|
||||
|
||||
/**
|
||||
* @brief
|
||||
* [Namespace](https://docs.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers)
|
||||
* [Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers)
|
||||
* of Azure service request is made against.
|
||||
*
|
||||
* @remarks Azure Specific attribute.
|
||||
|
||||
@ -182,7 +182,7 @@ void WinSocketSetBuffSize(curl_socket_t socket)
|
||||
{
|
||||
// if WSAloctl succeeded (returned 0), set the socket buffer size.
|
||||
// Specifies the total per-socket buffer space reserved for sends.
|
||||
// https://docs.microsoft.com/windows/win32/api/winsock/nf-winsock-setsockopt
|
||||
// https://learn.microsoft.com/windows/win32/api/winsock/nf-winsock-setsockopt
|
||||
setsockopt(socket, SOL_SOCKET, SO_SNDBUF, (const char*)&ideal, sizeof(ideal));
|
||||
}
|
||||
}
|
||||
|
||||
@ -9,7 +9,7 @@ Represents the build file for the container in which the test runs, it is based
|
||||
The main change from default Ubuntu is making sure we have the Valgrind tool installed. Valgrind is a heap monitoring tool that helps identify potential stack traces that might leak memory. While not 100% effective is great at reducing the surface are for investigations.
|
||||
|
||||
### Helm chart (https://helm.sh/)
|
||||
Chart.yaml together with the bicep file(https://docs.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
Chart.yaml together with the bicep file(https://learn.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
|
||||
The helm chart creates a pod with a container based on the docker image, and executes the test under Valgrind.
|
||||
|
||||
|
||||
@ -35,7 +35,7 @@ Once building is completed, a performance test application will be created insid
|
||||
./sdk/core/perf/test/azure-perf-test
|
||||
```
|
||||
|
||||
>Note: When building the code with Windows using Visual Studio, use the [CMake project view](https://docs.microsoft.com/cpp/build/cmake-projects-in-visual-studio?view=msvc-160) to run the performance tests. Find the tests directly in the tests folder from the cmake tree next to all other test cmake projects.
|
||||
>Note: When building the code with Windows using Visual Studio, use the [CMake project view](https://learn.microsoft.com/cpp/build/cmake-projects-in-visual-studio?view=msvc-160) to run the performance tests. Find the tests directly in the tests folder from the cmake tree next to all other test cmake projects.
|
||||
|
||||
#### Options for running
|
||||
|
||||
|
||||
@ -27,8 +27,8 @@ vcpkg install azure-messaging-eventhubs-checkpointstore-blob-cpp
|
||||
|
||||
- A C++ Compiler with C++14 support
|
||||
- An [Azure subscription](https://azure.microsoft.com/free/)
|
||||
- An [Event Hub namespace](https://docs.microsoft.com/azure/event-hubs/).
|
||||
- An Event Hub. You can create an event hub in your Event Hubs Namespace using the [Azure Portal](https://docs.microsoft.com/azure/event-hubs/event-hubs-create), or the [Azure CLI](https://docs.microsoft.com/azure/event-hubs/event-hubs-quickstart-cli).
|
||||
- An [Event Hub namespace](https://learn.microsoft.com/azure/event-hubs/).
|
||||
- An Event Hub. You can create an event hub in your Event Hubs Namespace using the [Azure Portal](https://learn.microsoft.com/azure/event-hubs/event-hubs-create), or the [Azure CLI](https://learn.microsoft.com/azure/event-hubs/event-hubs-quickstart-cli).
|
||||
|
||||
## Contributing
|
||||
For details on contributing to this repository, see the [contributing guide][azure_sdk_for_cpp_contributing].
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_MESSAGING_EVENTHUBS_CHECKPOINTSTORE_BLOB_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_MESSAGING_EVENTHUBS_CHECKPOINTSTORE_BLOB_DLL) \
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
<!-- cspell:words azeventhubs -->
|
||||
# Azure Event Hubs Client Package for C++
|
||||
|
||||
[Azure Event Hubs](https://azure.microsoft.com/services/event-hubs/) is a big data streaming platform and event ingestion service from Microsoft. For more information about Event Hubs see: [link](https://docs.microsoft.com/azure/event-hubs/event-hubs-about).
|
||||
[Azure Event Hubs](https://azure.microsoft.com/services/event-hubs/) is a big data streaming platform and event ingestion service from Microsoft. For more information about Event Hubs see: [link](https://learn.microsoft.com/azure/event-hubs/event-hubs-about).
|
||||
|
||||
Use the client library `github.com/Azure/azure-sdk-for-cpp/sdk/eventhubs` in your application to:
|
||||
|
||||
@ -28,8 +28,8 @@ vcpkg install azure-messaging-eventhubs-cpp
|
||||
|
||||
- A C++ Compiler with C++14 support
|
||||
- An [Azure subscription](https://azure.microsoft.com/free/)
|
||||
- An [Event Hub namespace](https://docs.microsoft.com/azure/event-hubs/).
|
||||
- An Event Hub. You can create an event hub in your Event Hubs Namespace using the [Azure Portal](https://docs.microsoft.com/azure/event-hubs/event-hubs-create), or the [Azure CLI](https://docs.microsoft.com/azure/event-hubs/event-hubs-quickstart-cli).
|
||||
- An [Event Hub namespace](https://learn.microsoft.com/azure/event-hubs/).
|
||||
- An Event Hub. You can create an event hub in your Event Hubs Namespace using the [Azure Portal](https://learn.microsoft.com/azure/event-hubs/event-hubs-create), or the [Azure CLI](https://learn.microsoft.com/azure/event-hubs/event-hubs-quickstart-cli).
|
||||
|
||||
#### Create a namespace using the Azure CLI
|
||||
|
||||
@ -145,19 +145,19 @@ Alternatively, you can create a client using a connection string.
|
||||
|
||||
# Key concepts
|
||||
|
||||
An Event Hub [**namespace**](https://docs.microsoft.com/azure/event-hubs/event-hubs-features#namespace) can have multiple event hubs.
|
||||
Each event hub, in turn, contains [**partitions**](https://docs.microsoft.com/azure/event-hubs/event-hubs-features#partitions) which
|
||||
An Event Hub [**namespace**](https://learn.microsoft.com/azure/event-hubs/event-hubs-features#namespace) can have multiple event hubs.
|
||||
Each event hub, in turn, contains [**partitions**](https://learn.microsoft.com/azure/event-hubs/event-hubs-features#partitions) which
|
||||
store events.
|
||||
|
||||
<!-- NOTE: Fix dead links -->
|
||||
Events are published to an event hub using an [event publisher](https://docs.microsoft.com/azure/event-hubs/event-hubs-features#event-publishers). In this package, the event publisher is the [ProducerClient](https://azure.github.io/azure-sdk-for-cpp/storage.html)
|
||||
Events are published to an event hub using an [event publisher](https://learn.microsoft.com/azure/event-hubs/event-hubs-features#event-publishers). In this package, the event publisher is the [ProducerClient](https://azure.github.io/azure-sdk-for-cpp/storage.html)
|
||||
|
||||
Events can be consumed from an event hub using an [event consumer](https://docs.microsoft.com/azure/event-hubs/event-hubs-features#event-consumers). In this package there are two types for consuming events:
|
||||
Events can be consumed from an event hub using an [event consumer](https://learn.microsoft.com/azure/event-hubs/event-hubs-features#event-consumers). In this package there are two types for consuming events:
|
||||
- The basic event consumer is the PartitionClient, in the [ConsumerClient][consumer_client]. This consumer is useful if you already known which partitions you want to receive from.
|
||||
- A distributed event consumer, which uses Azure Blobs for checkpointing and coordination. This is implemented in the [Processor](https://azure.github.io/azure-sdk-for-cpp/storage.html).
|
||||
The Processor is useful when you want to have the partition assignment be dynamically chosen, and balanced with other Processor instances.
|
||||
|
||||
More information about Event Hubs features and terminology can be found here: [link](https://docs.microsoft.com/azure/event-hubs/event-hubs-features)
|
||||
More information about Event Hubs features and terminology can be found here: [link](https://learn.microsoft.com/azure/event-hubs/event-hubs-features)
|
||||
|
||||
|
||||
# Examples
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_MESSAGING_EVENTHUBS_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_MESSAGING_EVENTHUBS_DLL) || (0 /*@AZ_MESSAGING_EVENTHUBS_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -9,7 +9,7 @@ Represents the build file for the container in which the test runs, it is based
|
||||
The main change from default Ubuntu is making sure we have the Valgrind tool installed. Valgrind is a heap monitoring tool that helps identify potential stack traces that might leak memory. While not 100% effective is great at reducing the surface are for investigations.
|
||||
|
||||
### Helm chart (https://helm.sh/)
|
||||
Chart.yaml together with the bicep file(https://docs.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
Chart.yaml together with the bicep file(https://learn.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
|
||||
The helm chart creates a pod with a container based on the docker image, and executes the test under Valgrind.
|
||||
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
# Azure Key Vault Client Librares for C++
|
||||
|
||||
The Azure Key Vault Client Libraries for C++ allows you to build applications against Microsoft Azure Key Vault services like Keys, Certificates and Secrets. For an overview of Azure Key Vault, see [Introduction to Microsoft Azure Key Vault](https://docs.microsoft.com/azure/key-vault).
|
||||
The Azure Key Vault Client Libraries for C++ allows you to build applications against Microsoft Azure Key Vault services like Keys, Certificates and Secrets. For an overview of Azure Key Vault, see [Introduction to Microsoft Azure Key Vault](https://learn.microsoft.com/azure/key-vault).
|
||||
|
||||
## Latest release
|
||||
|
||||
|
||||
@ -307,11 +307,11 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[api_reference]: https://azure.github.io/azure-sdk-for-cpp/keyvault.html
|
||||
[administration_client_src]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/keyvault/azure-security-keyvault-administration
|
||||
[keyvault_docs]: https://docs.microsoft.com/azure/key-vault/
|
||||
[keyvault_docs]: https://learn.microsoft.com/azure/key-vault/
|
||||
[access_control]: https://learn.microsoft.com/azure/key-vault/managed-hsm/access-control
|
||||
[access_policy]: https://learn.microsoft.com/azure/key-vault/general/assign-access-policy
|
||||
[rbac_guide]: https://learn.microsoft.com/azure/key-vault/general/rbac-guide
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZURE_SECURITY_KEYVAULT_ADMINISTRATION_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZURE_SECURITY_KEYVAULT_ADMINISTRATION_DLL) \
|
||||
|
||||
@ -362,11 +362,11 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[api_reference]: https://azure.github.io/azure-sdk-for-cpp/keyvault.html
|
||||
[certificate_client_src]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/keyvault/azure-security-keyvault-certificates
|
||||
[code_of_conduct]: https://opensource.microsoft.com/codeofconduct/
|
||||
[keyvault_docs]: https://docs.microsoft.com/azure/key-vault/
|
||||
[keyvault_rest]: https://docs.microsoft.com/rest/api/keyvault/
|
||||
[keyvault_docs]: https://learn.microsoft.com/azure/key-vault/
|
||||
[keyvault_rest]: https://learn.microsoft.com/rest/api/keyvault/
|
||||
[contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
|
||||
@ -331,7 +331,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the NIST P-256 elliptic curve, AKA SECG curve SECP256R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -341,7 +341,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the SECG SECP256K1 elliptic curve.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -351,7 +351,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the NIST P-384 elliptic curve, AKA SECG curve SECP384R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -361,7 +361,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the NIST P-521 elliptic curve, AKA SECG curve SECP521R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -453,7 +453,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the NIST P-256 elliptic curve, AKA SECG curve SECP256R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -463,7 +463,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the SECG SECP256K1 elliptic curve.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -645,7 +645,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Certificat
|
||||
* @brief Get the NIST P-256 elliptic curve, AKA SECG curve SECP256R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_SECURITY_KEYVAULT_CERTIFICATES_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_SECURITY_KEYVAULT_CERTIFICATES_DLL) \
|
||||
|
||||
@ -230,7 +230,7 @@ CryptographyClient cryptoClient(key.Id, credential);
|
||||
|
||||
|
||||
#### Note
|
||||
Microsoft recommends you not use CBC without first ensuring the integrity of the cipher text using an HMAC, for example. See https://docs.microsoft.com/dotnet/standard/security/vulnerabilities-cbc-mode for more information.
|
||||
Microsoft recommends you not use CBC without first ensuring the integrity of the cipher text using an HMAC, for example. See https://learn.microsoft.com/dotnet/standard/security/vulnerabilities-cbc-mode for more information.
|
||||
|
||||
Optional initialization vector (IV). If you pass your own IV, make sure you use a cryptographically random, non-repeating IV. If null, a cryptographically random IV will be choosing using {RandomNumberGenerator | whatever cryptorng your language provides}.
|
||||
|
||||
@ -325,7 +325,7 @@ std::cout << updatedKey.Properties.UpdatedOn->ToString();
|
||||
|
||||
`StartDeleteKey` starts a long-running operation to delete a key previously stored in the Azure Key Vault.
|
||||
You can retrieve the key immediately without waiting for the operation to complete.
|
||||
When [soft-delete](https://docs.microsoft.com/azure/key-vault/general/soft-delete-overview) is not enabled for the Azure Key Vault, this operation permanently deletes the key.
|
||||
When [soft-delete](https://learn.microsoft.com/azure/key-vault/general/soft-delete-overview) is not enabled for the Azure Key Vault, this operation permanently deletes the key.
|
||||
|
||||
```cpp
|
||||
DeleteKeyOperation operation = client.StartDeleteKey("key-name");
|
||||
@ -478,7 +478,7 @@ For more information see the [Code of Conduct FAQ][coc_faq] or contact opencode@
|
||||
|
||||
[azsdk_vcpkg_install]: https://github.com/Azure/azure-sdk-for-cpp#download--install-the-sdk
|
||||
[api_reference]: https://azure.github.io/azure-sdk-for-cpp/keyvault.html
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_identity]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/identity/azure-identity
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
<!-- ----------------SAMPLES ---------------- -->
|
||||
@ -499,15 +499,15 @@ For more information see the [Code of Conduct FAQ][coc_faq] or contact opencode@
|
||||
[key_client_vcpkg_package]: https://github.com/microsoft/vcpkg/tree/master/ports/azure-security-keyvault-keys-cpp
|
||||
[key_client_samples]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/keyvault/azure-security-keyvault-keys/samples
|
||||
[key_client_src]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/keyvault/azure-security-keyvault-keys
|
||||
[keyvault_docs]: https://docs.microsoft.com/azure/key-vault/
|
||||
[keyvault_rest]: https://docs.microsoft.com/rest/api/keyvault/
|
||||
[keyvault_docs]: https://learn.microsoft.com/azure/key-vault/
|
||||
[keyvault_rest]: https://learn.microsoft.com/rest/api/keyvault/
|
||||
|
||||
<!-- [secrets_client_library]: https://github.com/Azure/azure-sdk-for-net/tree/main/sdk/keyvault/Azure.Security.KeyVault.Secrets -->
|
||||
|
||||
[defaultazurecredential]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/identity/azure-identity#credentials
|
||||
[contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
|
||||
[access_control]: https://docs.microsoft.com/azure/key-vault/managed-hsm/access-control
|
||||
[rbac_guide]: https://docs.microsoft.com/azure/key-vault/general/rbac-guide
|
||||
[access_control]: https://learn.microsoft.com/azure/key-vault/managed-hsm/access-control
|
||||
[rbac_guide]: https://learn.microsoft.com/azure/key-vault/general/rbac-guide
|
||||
[azsdk_vcpkg_install]: https://github.com/Azure/azure-sdk-for-cpp#getting-started
|
||||
[project_set_up_examples]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/samples/integration
|
||||
|
||||
@ -32,7 +32,7 @@ namespace Azure {
|
||||
/**
|
||||
* @brief Gets the ServiceVersion of the service API used when making requests. For more
|
||||
* information, see [Key Vault
|
||||
* versions](https://docs.microsoft.com/rest/api/keyvault/key-vault-versions).
|
||||
* versions](https://learn.microsoft.com/rest/api/keyvault/key-vault-versions).
|
||||
*
|
||||
*/
|
||||
std::string Version;
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_SECURITY_KEYVAULT_KEYS_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_SECURITY_KEYVAULT_KEYS_DLL) \
|
||||
|
||||
@ -264,7 +264,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Keys {
|
||||
* @brief Gets the NIST P-256 elliptic curve, AKA SECG curve SECP256R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -274,7 +274,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Keys {
|
||||
* @brief Gets the SECG SECP256K1 elliptic curve.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -284,7 +284,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Keys {
|
||||
* @brief Gets the NIST P-384 elliptic curve, AKA SECG curve SECP384R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
@ -294,7 +294,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Keys {
|
||||
* @brief Gets the NIST P-521 elliptic curve, AKA SECG curve SECP521R1.
|
||||
*
|
||||
* @remark For more information, see
|
||||
* <a href="https://docs.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* <a href="https://learn.microsoft.com/azure/key-vault/keys/about-keys#curve-types">Curve
|
||||
* types</a>.
|
||||
*
|
||||
*/
|
||||
|
||||
@ -23,7 +23,7 @@ TEST_F(KeyVaultKeyClient, ImportKey)
|
||||
|
||||
JsonWebKey key;
|
||||
key.KeyType = KeyVaultKeyType::Rsa;
|
||||
// Values from https://docs.microsoft.com/rest/api/keyvault/importkey/importkey
|
||||
// Values from https://learn.microsoft.com/rest/api/keyvault/importkey/importkey
|
||||
// cspell:disable
|
||||
key.N = Base64Url::Base64UrlDecode(
|
||||
"nKAwarTrOpzd1hhH4cQNdVTgRF-b0ubPD8ZNVf0UXjb62QuAk3Dn68ESThcF7SoDYRx2QVcfoMC9WCcuQUQDieJF-"
|
||||
|
||||
@ -24,7 +24,7 @@ namespace Azure { namespace Security { namespace KeyVault { namespace Keys { nam
|
||||
|
||||
namespace _detail {
|
||||
// Return a simple key as response so keyvault can parse it to create the T response
|
||||
// Fake key from https://docs.microsoft.com/rest/api/keyvault/GetKey/GetKey#examples
|
||||
// Fake key from https://learn.microsoft.com/rest/api/keyvault/GetKey/GetKey#examples
|
||||
static const char FakeKey[]
|
||||
= "{ \"key\": { \"kid\": "
|
||||
"\"https://myvault.vault.azure.net/keys/CreateSoftKeyTest/"
|
||||
|
||||
@ -267,10 +267,10 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[api_reference]: https://azure.github.io/azure-sdk-for-cpp/keyvault.html
|
||||
[secrets_client_src]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/keyvault/azure-security-keyvault-secrets
|
||||
[keyvault_docs]: https://docs.microsoft.com/azure/key-vault/
|
||||
[keyvault_docs]: https://learn.microsoft.com/azure/key-vault/
|
||||
[azsdk_vcpkg_install]: https://github.com/Azure/azure-sdk-for-cpp#getting-started
|
||||
[project_set_up_examples]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/samples/integration
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZURE_SECURITY_KEYVAULT_SECRETS_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZURE_SECURITY_KEYVAULT_SECRETS_DLL) \
|
||||
|
||||
@ -3,7 +3,7 @@
|
||||
This guide intends to assist customers in migrating from legacy versions of the Azure Storage C++ library for Blobs to version 12.
|
||||
While this guide is generally applicable to older versions of the SDK, it was written with v7.5 in mind as the starting point.
|
||||
It focuses on side-by-side comparisons for similar operations between the [v7.5 package](https://github.com/Azure/azure-storage-cpp) and [v12 package](https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/storage).
|
||||
Familiarity with the v7.5 client library is assumed. For those new to the Azure Storage Blobs client library for C++, please refer to the [Quickstart](https://docs.microsoft.com/azure/storage/blobs/quickstart-blobs-c-plus-plus) for the v12 library rather than this guide.
|
||||
Familiarity with the v7.5 client library is assumed. For those new to the Azure Storage Blobs client library for C++, please refer to the [Quickstart](https://learn.microsoft.com/azure/storage/blobs/quickstart-blobs-c-plus-plus) for the v12 library rather than this guide.
|
||||
|
||||
## Table of contents
|
||||
|
||||
@ -140,7 +140,7 @@ If you wish to rotate the key within your `BlobServiceClient` (and any derived c
|
||||
The modern SDK has taken a client-based approach. There are no objects designed to be representations of storage resources, but instead clients that act as your mechanism to interact with your storage resources in the cloud. **Clients hold no state of your resources.** (Lease client is an exception.) This is most noticeable when looking at [blob metadata](#managing-blob-metadata).
|
||||
|
||||
The hierarchical structure of Azure Blob Storage can be understood by the following diagram:
|
||||

|
||||

|
||||
|
||||
In the interest of simplifying the API surface, v12 uses three top level clients to match this structure that can be used to interact with a majority of your resources: `BlobServiceClient`, `BlobContainerClient`, and `BlobClient`. Note that blob-type-specific operations can still be accessed by their specific clients, as in v7.5.
|
||||
|
||||
@ -148,7 +148,7 @@ In the interest of simplifying the API surface, v12 uses three top level clients
|
||||
|
||||
Note the absence of a v12 equivalent for v7.5's `cloud_blob_directory`. Directories were an SDK-only concept that did not exist in Azure Blob Storage, and which were not brought forwards into the modern Storage SDK. As shown by the diagram in [Client Structure](#client-structure), containers only contain a flat list of blobs, but those blobs can be named and listed in ways that imply a folder-like structure. See our [Listing Blobs in a Container](#listing-blobs-in-a-container) migration samples later in this guide for more information.
|
||||
|
||||
For those whose workloads revolve around manipulating directories and heavily relied on the legacy SDKs abstraction of this structure, consider the [pros and cons of enabling hierarchical namespace](https://docs.microsoft.com/azure/storage/blobs/data-lake-storage-namespace) on your storage account, which would allow switching to the [Data Lake Gen 2 SDK](https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/storage/azure-storage-files-datalake), whose migration is not covered in this document.
|
||||
For those whose workloads revolve around manipulating directories and heavily relied on the legacy SDKs abstraction of this structure, consider the [pros and cons of enabling hierarchical namespace](https://learn.microsoft.com/azure/storage/blobs/data-lake-storage-namespace) on your storage account, which would allow switching to the [Data Lake Gen 2 SDK](https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/storage/azure-storage-files-datalake), whose migration is not covered in this document.
|
||||
|
||||
#### Class Conversion Reference
|
||||
|
||||
@ -294,7 +294,7 @@ for (auto blobPage = containerClient.ListBlobs(); blobPage.HasPage(); blobPage.M
|
||||
|
||||
#### Hierarchical Listing
|
||||
|
||||
See the [list blobs documentation](https://docs.microsoft.com/azure/storage/blobs/storage-blobs-list?tabs=dotnet#flat-listing-versus-hierarchical-listing) for more information on what a hierarchical listing is.
|
||||
See the [list blobs documentation](https://learn.microsoft.com/azure/storage/blobs/storage-blobs-list?tabs=dotnet#flat-listing-versus-hierarchical-listing) for more information on what a hierarchical listing is.
|
||||
|
||||
v7.5
|
||||
|
||||
@ -496,9 +496,9 @@ task.wait();
|
||||
|
||||
### Samples
|
||||
More examples can be found at:
|
||||
- [Azure Storage samples using v12 C++ Client Libraries](https://docs.microsoft.com/azure/storage/common/storage-samples-c-plus-plus?toc=/azure/storage/blobs/toc.json)
|
||||
- [Azure Storage samples using v12 C++ Client Libraries](https://learn.microsoft.com/azure/storage/common/storage-samples-c-plus-plus?toc=/azure/storage/blobs/toc.json)
|
||||
|
||||
### Links and references
|
||||
- [Quickstart](https://docs.microsoft.com/azure/storage/blobs/quickstart-blobs-c-plus-plus)
|
||||
- [Samples](https://docs.microsoft.com/azure/storage/common/storage-samples-c-plus-plus?toc=/azure/storage/blobs/toc.json)
|
||||
- [Quickstart](https://learn.microsoft.com/azure/storage/blobs/quickstart-blobs-c-plus-plus)
|
||||
- [Samples](https://learn.microsoft.com/azure/storage/common/storage-samples-c-plus-plus?toc=/azure/storage/blobs/toc.json)
|
||||
- [C++ SDK reference](https://azure.github.io/azure-sdk-for-cpp/storage.html#azure-storage-blobs)
|
||||
|
||||
@ -79,7 +79,7 @@ namespace Azure { namespace Storage { namespace Blobs {
|
||||
|
||||
/**
|
||||
* @brief Optional SQL statement to apply to the tags of the Blob. Refer to
|
||||
* https://docs.microsoft.com/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-predicate-syntax
|
||||
* https://learn.microsoft.com/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-predicate-syntax
|
||||
* for the format of SQL statements.
|
||||
*/
|
||||
Azure::Nullable<std::string> TagConditions;
|
||||
@ -188,7 +188,7 @@ namespace Azure { namespace Storage { namespace Blobs {
|
||||
* operation against another host. If SecondaryHostForRetryReads is "" (the default) then
|
||||
* operations are not retried against another host. NOTE: Before setting this field, make sure
|
||||
* you understand the issues around reading stale & potentially-inconsistent data at this
|
||||
* webpage: https://docs.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
* webpage: https://learn.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
*/
|
||||
std::string SecondaryHostForRetryReads;
|
||||
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_STORAGE_BLOBS_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_STORAGE_BLOBS_DLL) || (0 /*@AZ_STORAGE_BLOBS_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -1756,7 +1756,7 @@ namespace Azure { namespace Storage { namespace Blobs {
|
||||
/**
|
||||
* The tier of page blob on a premium storage account or tier of block blob on blob storage
|
||||
* LRS accounts. For a list of allowed premium page blob tiers, see
|
||||
* https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features.
|
||||
* https://learn.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features.
|
||||
* For blob storage LRS accounts, valid values are Hot/Cool/Archive.
|
||||
*/
|
||||
Nullable<Models::AccessTier> AccessTier;
|
||||
|
||||
@ -372,7 +372,7 @@ namespace Azure { namespace Storage { namespace Test {
|
||||
TEST_F(BlobContainerClientTest, ListBlobsOtherStuff)
|
||||
{
|
||||
// NOTE: This test Requires storage account with versioning enabled!
|
||||
// https://docs.microsoft.com/en-us/azure/storage/blobs/versioning-enable?tabs=portal
|
||||
// https://learn.microsoft.com/en-us/azure/storage/blobs/versioning-enable?tabs=portal
|
||||
auto containerClient = *m_blobContainerClient;
|
||||
|
||||
std::string blobName = "blob" + m_containerName;
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_STORAGE_COMMON_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_STORAGE_COMMON_DLL) || (0 /*@AZ_STORAGE_COMMON_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -163,7 +163,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* operation against another host. If SecondaryHostForRetryReads is "" (the default) then
|
||||
* operations are not retried against another host. NOTE: Before setting this field, make sure
|
||||
* you understand the issues around reading stale & potentially-inconsistent data at this
|
||||
* webpage: https://docs.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
* webpage: https://learn.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
*/
|
||||
std::string SecondaryHostForRetryReads;
|
||||
|
||||
@ -419,7 +419,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* #Azure::Storage::Files::DataLake::DataLakeFileSystemClient::RenameDirectory.
|
||||
* @remark Some optional parameter is mandatory in certain combination.
|
||||
* More details:
|
||||
* https://docs.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
|
||||
* https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
|
||||
*/
|
||||
struct RenameDirectoryOptions final
|
||||
{
|
||||
@ -651,7 +651,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* @brief Optional parameters for #Azure::Storage::Files::DataLake::DataLakePathClient::Create.
|
||||
* @remark Some optional parameter is mandatory in certain combination.
|
||||
* More details:
|
||||
* https://docs.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
|
||||
* https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/create
|
||||
*/
|
||||
struct CreatePathOptions final
|
||||
{
|
||||
@ -739,7 +739,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* @brief Optional parameters for Azure::Storage::Files::DataLake::DirectoryClient::Delete.
|
||||
* @remark Some optional parameter is mandatory in certain combination.
|
||||
* More details:
|
||||
* https://docs.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete
|
||||
* https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/delete
|
||||
*/
|
||||
struct DeletePathOptions final
|
||||
{
|
||||
@ -760,7 +760,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* #Azure::Storage::Files::DataLake::DataLakePathClient::GetProperties.
|
||||
* @remark Some optional parameter is mandatory in certain combination.
|
||||
* More details:
|
||||
* https://docs.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties
|
||||
* https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/getproperties
|
||||
*/
|
||||
struct GetPathPropertiesOptions final
|
||||
{
|
||||
@ -808,7 +808,7 @@ namespace Azure { namespace Storage { namespace Files { namespace DataLake {
|
||||
* @brief Optional parameters for #Azure::Storage::Files::DataLake::DataLakeFileClient::Download.
|
||||
* @remark Some optional parameter is mandatory in certain combination.
|
||||
* More details:
|
||||
* https://docs.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/read
|
||||
* https://learn.microsoft.com/rest/api/storageservices/datalakestoragegen2/path/read
|
||||
*/
|
||||
struct DownloadFileOptions final
|
||||
{
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_STORAGE_FILES_DATALAKE_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_STORAGE_FILES_DATALAKE_DLL) \
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_STORAGE_FILES_SHARES_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_STORAGE_FILES_SHARES_DLL) \
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_STORAGE_QUEUES_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_STORAGE_QUEUES_DLL) || (0 /*@AZ_STORAGE_QUEUES_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -121,7 +121,7 @@ namespace Azure { namespace Storage { namespace Queues {
|
||||
* operation against another host. If SecondaryHostForRetryReads is "" (the default) then
|
||||
* operations are not retried against another host. NOTE: Before setting this field, make sure
|
||||
* you understand the issues around reading stale & potentially-inconsistent data at this
|
||||
* webpage: https://docs.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
* webpage: https://learn.microsoft.com/azure/storage/common/geo-redundant-design.
|
||||
*/
|
||||
std::string SecondaryHostForRetryReads;
|
||||
|
||||
|
||||
@ -295,18 +295,18 @@ additional questions or comments.
|
||||
[coc_faq]: https://opensource.microsoft.com/codeofconduct/faq/
|
||||
[coc_contact]: mailto:opencode@microsoft.com
|
||||
[source_code]:https://github.com/Azure/azure-sdk-for-cpp/tree/main/sdk/
|
||||
[Tables_product_doc]:https://docs.microsoft.com/azure/cosmos-db/table-introduction
|
||||
[Tables_product_doc]:https://learn.microsoft.com/azure/cosmos-db/table-introduction
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_subscription]:https://azure.microsoft.com/free/
|
||||
[azure_storage_account]:https://docs.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-portal
|
||||
[azure_cosmos_account]:https://docs.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_create_cosmos]:https://docs.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_cli_create_cosmos]:https://docs.microsoft.com/azure/cosmos-db/scripts/cli/table/create
|
||||
[azure_portal_create_cosmos]:https://docs.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_portal_create_account]:https://docs.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-portal
|
||||
[azure_powershell_create_account]:https://docs.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-powershell
|
||||
[azure_cli_create_account]: https://docs.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-cli
|
||||
[azure_storage_account]:https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-portal
|
||||
[azure_cosmos_account]:https://learn.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_create_cosmos]:https://learn.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_cli_create_cosmos]:https://learn.microsoft.com/azure/cosmos-db/scripts/cli/table/create
|
||||
[azure_portal_create_cosmos]:https://learn.microsoft.com/azure/cosmos-db/create-cosmosdb-resources-portal
|
||||
[azure_portal_create_account]:https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-portal
|
||||
[azure_powershell_create_account]:https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-powershell
|
||||
[azure_cli_create_account]: https://learn.microsoft.com/azure/storage/common/storage-account-create?tabs=azure-cli
|
||||
[azsdk_vcpkg_install]: https://github.com/Azure/azure-sdk-for-cpp#getting-started
|
||||
[project_set_up_examples]: https://github.com/Azure/azure-sdk-for-cpp/tree/main/samples/integration
|
||||
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_DATA_TABLES_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_DATA_TABLES_DLL) || (0 /*@AZ_DATA_TABLES_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
@ -9,7 +9,7 @@ Represents the build file for the container in which the test runs, it is based
|
||||
The main change from default Ubuntu is making sure we have the Valgrind tool installed. Valgrind is a heap monitoring tool that helps identify potential stack traces that might leak memory. While not 100% effective is great at reducing the surface are for investigations.
|
||||
|
||||
### Helm chart (https://helm.sh/)
|
||||
Chart.yaml together with the bicep file(https://docs.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
Chart.yaml together with the bicep file(https://learn.microsoft.com/azure/azure-resource-manager/bicep/overview?tabs=bicep) and the deploy job file , represent the helm chart needed to deploy to the docker image built from the dockerfile to the stress cluster and execute the stress test.
|
||||
|
||||
The helm chart creates a pod with a container based on the docker image, and executes the test under Valgrind.
|
||||
|
||||
|
||||
@ -60,11 +60,11 @@ Azure SDK for C++ is licensed under the [MIT](https://github.com/Azure/azure-sdk
|
||||
[azure_sdk_for_cpp_contributing]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md
|
||||
[azure_sdk_for_cpp_contributing_developer_guide]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#developer-guide
|
||||
[azure_sdk_for_cpp_contributing_pull_requests]: https://github.com/Azure/azure-sdk-for-cpp/blob/main/CONTRIBUTING.md#pull-requests
|
||||
[azure_cli]: https://docs.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://docs.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://docs.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_cli]: https://learn.microsoft.com/cli/azure
|
||||
[azure_pattern_circuit_breaker]: https://learn.microsoft.com/azure/architecture/patterns/circuit-breaker
|
||||
[azure_pattern_retry]: https://learn.microsoft.com/azure/architecture/patterns/retry
|
||||
[azure_portal]: https://portal.azure.com
|
||||
[azure_sub]: https://azure.microsoft.com/free/
|
||||
[c_compiler]: https://visualstudio.microsoft.com/vs/features/cplusplus/
|
||||
[cloud_shell]: https://docs.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell]: https://learn.microsoft.com/azure/cloud-shell/overview
|
||||
[cloud_shell_bash]: https://shell.azure.com/bash
|
||||
|
||||
@ -13,7 +13,7 @@
|
||||
/**
|
||||
* @def AZ_TEMPLATE_DLLEXPORT
|
||||
* @brief Applies DLL export attribute, when applicable.
|
||||
* @note See https://docs.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
* @note See https://learn.microsoft.com/cpp/cpp/dllexport-dllimport?view=msvc-160.
|
||||
*/
|
||||
|
||||
#if defined(AZ_TEMPLATE_DLL) || (0 /*@AZ_TEMPLATE_DLL_INSTALLED_AS_PACKAGE@*/)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user