Azure-docs: Notebook: Unclear instructions on how to upload sample images to Azure Blob Container

Created on 1 Oct 2018  Â·  6Comments  Â·  Source: MicrosoftDocs/azure-docs

To complete the example notebook, there is an instruction to 'Get samples images and upload to Datastore'. There is, however, no instructions on where to actually upload the sample images to an Azure Blob Container. There are a few links to instructions on _how_, but not to _where_. It would be useful if the guide could be a little more detailed on that matter. Where is the Datastore? I have multiple existing Blob Containers in the automatically created storage resource, which one should I use? Should the folders be uploaded as-is, or should they be renamed?

The code snippet that follows the manual instructions is dependent on this step being properly executed, and some hints on how to correctly upload the sample images could be added here. For example, the parameters in the call Datastore.register_azure_blob_container(ws, "sampledata", "sampledata", account_name=account_name, overwrite=True) could be explained. What is the reason the two strings are both 'sampledata'?

All other notebooks I have come across so far have been more clear on all steps. I think this would benefit from being a little more clear as well.


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

assigned-to-author doc-enhancement machine-learninsvc triaged

All 6 comments

@ArvidBaa Thanks for the feedback! I have assigned the issue to the content author to evaluate and update as appropriate.

Thanks for the feedback. We are working on updating the notebook.

@sanpil - has this been addressed?

Yes, this has been addressed. In the latest update, we have modified the code and used named parameters. As in:

account_name = "pipelinedata"
sample_data = Datastore.register_azure_blob_container(
ws, datastore_name="images_datastore",
container_name="sampledata",
account_name=account_name,
overwrite=True)

@sanpil thanks.
@YutongTie-MSFT #please-close
@ArvidBaa - reopen if not a fix.

@ArvidBaa We will now proceed to close this thread. If there are further questions regarding this matter, please tag me in your reply. We will gladly continue the discussion and we will reopen the issue.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

spottedmahn picture spottedmahn  Â·  3Comments

bityob picture bityob  Â·  3Comments

Ponant picture Ponant  Â·  3Comments

ianpowell2017 picture ianpowell2017  Â·  3Comments

bdcoder2 picture bdcoder2  Â·  3Comments